@athenaintel/sdk 4.3.2298 → 4.3.2299

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -43,8 +43,8 @@ function normalizeClientOptions(options) {
43
43
  const headers = (0, headers_js_1.mergeHeaders)({
44
44
  "X-Fern-Language": "JavaScript",
45
45
  "X-Fern-SDK-Name": "@athenaintel/sdk",
46
- "X-Fern-SDK-Version": "4.3.2298",
47
- "User-Agent": "@athenaintel/sdk/4.3.2298",
46
+ "X-Fern-SDK-Version": "4.3.2299",
47
+ "User-Agent": "@athenaintel/sdk/4.3.2299",
48
48
  "X-Fern-Runtime": core.RUNTIME.type,
49
49
  "X-Fern-Runtime-Version": core.RUNTIME.version,
50
50
  "X-Athena-Session-Credential": options === null || options === void 0 ? void 0 : options.sessionCredential,
@@ -157,6 +157,45 @@ export declare class AssetsClient {
157
157
  */
158
158
  duplicate(request: AthenaIntelligence.DuplicateAssetRequestIn, requestOptions?: AssetsClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.DuplicateAssetResponseOut>;
159
159
  private __duplicate;
160
+ /**
161
+ * Mint a one-time link that takes one file without an API key, for a caller that can run a shell command but holds no key, such as an agent connected through an Athena MCP server. The file's name decides what it becomes, as with POST /api/v0/assets/create-from-file: a .md, .markdown, .txt or .text file an Athena document, a .html or .htm file a user interface, a .docx file a Word document and a .pptx or .potx file a presentation. The gates of create-from-file run now (membership in the workspace, EDIT on parent_folder_id, the deployment's offering, an agent run's tool policy) and again when the file arrives. Send the file's bytes as the body of one PUT to upload_url with the X-Athena-Upload-Token header (the curl field is that command); its answer is the new asset. A link works once, for 15 minutes.
162
+ *
163
+ * @param {AthenaIntelligence.CreateUploadLinkRequestIn} request
164
+ * @param {AssetsClient.RequestOptions} requestOptions - Request-specific configuration.
165
+ *
166
+ * @throws {@link AthenaIntelligence.ForbiddenError}
167
+ * @throws {@link AthenaIntelligence.NotFoundError}
168
+ * @throws {@link AthenaIntelligence.UnprocessableEntityError}
169
+ * @throws {@link AthenaIntelligence.ServiceUnavailableError}
170
+ *
171
+ * @example
172
+ * await client.assets.createUploadLink({
173
+ * file_name: "notes.md",
174
+ * parent_folder_id: "asset_folder_12345",
175
+ * title: "Quarterly notes"
176
+ * })
177
+ */
178
+ createUploadLink(request: AthenaIntelligence.CreateUploadLinkRequestIn, requestOptions?: AssetsClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.UploadLinkResponseOut>;
179
+ private __createUploadLink;
180
+ /**
181
+ * Send one file through a link from POST /api/v0/assets/upload-links: the body is the file's bytes and X-Athena-Upload-Token the link's credential; no API key is needed. Athena runs POST /api/v0/assets/create-from-file as the person who asked for the link, with every gate again (an agent run's tool policy included), and answers with the new asset. A link works once: the first upload spends it, whatever its answer.
182
+ *
183
+ * @param {core.file.Uploadable} uploadable
184
+ * @param {string} link_id
185
+ * @param {AssetsClient.RequestOptions} requestOptions - Request-specific configuration.
186
+ *
187
+ * @throws {@link AthenaIntelligence.BadRequestError}
188
+ * @throws {@link AthenaIntelligence.UnauthorizedError}
189
+ * @throws {@link AthenaIntelligence.ForbiddenError}
190
+ * @throws {@link AthenaIntelligence.NotFoundError}
191
+ * @throws {@link AthenaIntelligence.GoneError}
192
+ * @throws {@link AthenaIntelligence.ContentTooLargeError}
193
+ * @throws {@link AthenaIntelligence.UnprocessableEntityError}
194
+ * @throws {@link AthenaIntelligence.BadGatewayError}
195
+ * @throws {@link AthenaIntelligence.ServiceUnavailableError}
196
+ */
197
+ uploadThroughLink(uploadable: core.file.Uploadable, link_id: string, requestOptions?: AssetsClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.CreateAssetResponseOut>;
198
+ private __uploadThroughLink;
160
199
  /**
161
200
  * Retrieve a single asset by its ID. Returns comprehensive metadata including creation info, tags, timestamps, media type, and AI-generated summary.
162
201
  *
@@ -724,6 +724,193 @@ class AssetsClient {
724
724
  }
725
725
  });
726
726
  }
727
+ /**
728
+ * Mint a one-time link that takes one file without an API key, for a caller that can run a shell command but holds no key, such as an agent connected through an Athena MCP server. The file's name decides what it becomes, as with POST /api/v0/assets/create-from-file: a .md, .markdown, .txt or .text file an Athena document, a .html or .htm file a user interface, a .docx file a Word document and a .pptx or .potx file a presentation. The gates of create-from-file run now (membership in the workspace, EDIT on parent_folder_id, the deployment's offering, an agent run's tool policy) and again when the file arrives. Send the file's bytes as the body of one PUT to upload_url with the X-Athena-Upload-Token header (the curl field is that command); its answer is the new asset. A link works once, for 15 minutes.
729
+ *
730
+ * @param {AthenaIntelligence.CreateUploadLinkRequestIn} request
731
+ * @param {AssetsClient.RequestOptions} requestOptions - Request-specific configuration.
732
+ *
733
+ * @throws {@link AthenaIntelligence.ForbiddenError}
734
+ * @throws {@link AthenaIntelligence.NotFoundError}
735
+ * @throws {@link AthenaIntelligence.UnprocessableEntityError}
736
+ * @throws {@link AthenaIntelligence.ServiceUnavailableError}
737
+ *
738
+ * @example
739
+ * await client.assets.createUploadLink({
740
+ * file_name: "notes.md",
741
+ * parent_folder_id: "asset_folder_12345",
742
+ * title: "Quarterly notes"
743
+ * })
744
+ */
745
+ createUploadLink(request, requestOptions) {
746
+ return core.HttpResponsePromise.fromPromise(this.__createUploadLink(request, requestOptions));
747
+ }
748
+ __createUploadLink(request, requestOptions) {
749
+ return __awaiter(this, void 0, void 0, function* () {
750
+ var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
751
+ const _authRequest = yield this._options.authProvider.getAuthRequest();
752
+ const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({
753
+ "X-Athena-Session-Credential": (_b = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.sessionCredential) !== null && _b !== void 0 ? _b : (_c = this._options) === null || _c === void 0 ? void 0 : _c.sessionCredential,
754
+ }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
755
+ const _response = yield ((_d = this._options.fetcher) !== null && _d !== void 0 ? _d : core.fetcher)({
756
+ url: core.url.join((_f = (_e = (yield core.Supplier.get(this._options.baseUrl))) !== null && _e !== void 0 ? _e : (yield core.Supplier.get(this._options.environment))) !== null && _f !== void 0 ? _f : environments.AthenaIntelligenceEnvironment.Production, "api/v0/assets/upload-links"),
757
+ method: "POST",
758
+ headers: _headers,
759
+ contentType: "application/json",
760
+ queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
761
+ requestType: "json",
762
+ body: request,
763
+ 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,
764
+ 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,
765
+ abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
766
+ fetchFn: (_m = this._options) === null || _m === void 0 ? void 0 : _m.fetch,
767
+ logging: this._options.logging,
768
+ });
769
+ if (_response.ok) {
770
+ return {
771
+ data: _response.body,
772
+ rawResponse: _response.rawResponse,
773
+ };
774
+ }
775
+ if (_response.error.reason === "status-code") {
776
+ switch (_response.error.statusCode) {
777
+ case 403:
778
+ throw new AthenaIntelligence.ForbiddenError(_response.error.body, _response.rawResponse);
779
+ case 404:
780
+ throw new AthenaIntelligence.NotFoundError(_response.error.body, _response.rawResponse);
781
+ case 422:
782
+ throw new AthenaIntelligence.UnprocessableEntityError(_response.error.body, _response.rawResponse);
783
+ case 503:
784
+ throw new AthenaIntelligence.ServiceUnavailableError(_response.error.body, _response.rawResponse);
785
+ default:
786
+ throw new errors.AthenaIntelligenceError({
787
+ statusCode: _response.error.statusCode,
788
+ body: _response.error.body,
789
+ rawResponse: _response.rawResponse,
790
+ });
791
+ }
792
+ }
793
+ switch (_response.error.reason) {
794
+ case "non-json":
795
+ throw new errors.AthenaIntelligenceError({
796
+ statusCode: _response.error.statusCode,
797
+ body: _response.error.rawBody,
798
+ rawResponse: _response.rawResponse,
799
+ });
800
+ case "body-is-null":
801
+ throw new errors.AthenaIntelligenceError({
802
+ statusCode: _response.error.statusCode,
803
+ rawResponse: _response.rawResponse,
804
+ });
805
+ case "timeout":
806
+ throw new errors.AthenaIntelligenceTimeoutError("Timeout exceeded when calling POST /api/v0/assets/upload-links.");
807
+ case "unknown":
808
+ throw new errors.AthenaIntelligenceError({
809
+ message: _response.error.errorMessage,
810
+ rawResponse: _response.rawResponse,
811
+ });
812
+ }
813
+ });
814
+ }
815
+ /**
816
+ * Send one file through a link from POST /api/v0/assets/upload-links: the body is the file's bytes and X-Athena-Upload-Token the link's credential; no API key is needed. Athena runs POST /api/v0/assets/create-from-file as the person who asked for the link, with every gate again (an agent run's tool policy included), and answers with the new asset. A link works once: the first upload spends it, whatever its answer.
817
+ *
818
+ * @param {core.file.Uploadable} uploadable
819
+ * @param {string} link_id
820
+ * @param {AssetsClient.RequestOptions} requestOptions - Request-specific configuration.
821
+ *
822
+ * @throws {@link AthenaIntelligence.BadRequestError}
823
+ * @throws {@link AthenaIntelligence.UnauthorizedError}
824
+ * @throws {@link AthenaIntelligence.ForbiddenError}
825
+ * @throws {@link AthenaIntelligence.NotFoundError}
826
+ * @throws {@link AthenaIntelligence.GoneError}
827
+ * @throws {@link AthenaIntelligence.ContentTooLargeError}
828
+ * @throws {@link AthenaIntelligence.UnprocessableEntityError}
829
+ * @throws {@link AthenaIntelligence.BadGatewayError}
830
+ * @throws {@link AthenaIntelligence.ServiceUnavailableError}
831
+ */
832
+ uploadThroughLink(uploadable, link_id, requestOptions) {
833
+ return core.HttpResponsePromise.fromPromise(this.__uploadThroughLink(uploadable, link_id, requestOptions));
834
+ }
835
+ __uploadThroughLink(uploadable, link_id, requestOptions) {
836
+ return __awaiter(this, void 0, void 0, function* () {
837
+ var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
838
+ const _binaryUploadRequest = yield core.file.toBinaryUploadRequest(uploadable);
839
+ const _authRequest = yield this._options.authProvider.getAuthRequest();
840
+ const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({
841
+ "X-Athena-Session-Credential": (_b = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.sessionCredential) !== null && _b !== void 0 ? _b : (_c = this._options) === null || _c === void 0 ? void 0 : _c.sessionCredential,
842
+ }), _binaryUploadRequest.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
843
+ const _response = yield ((_d = this._options.fetcher) !== null && _d !== void 0 ? _d : core.fetcher)({
844
+ url: core.url.join((_f = (_e = (yield core.Supplier.get(this._options.baseUrl))) !== null && _e !== void 0 ? _e : (yield core.Supplier.get(this._options.environment))) !== null && _f !== void 0 ? _f : environments.AthenaIntelligenceEnvironment.Production, `api/v0/assets/upload-links/${core.url.encodePathParam(link_id)}`),
845
+ method: "PUT",
846
+ headers: _headers,
847
+ contentType: "application/octet-stream",
848
+ queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
849
+ requestType: "bytes",
850
+ duplex: "half",
851
+ body: _binaryUploadRequest.body,
852
+ 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,
853
+ 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,
854
+ abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
855
+ fetchFn: (_m = this._options) === null || _m === void 0 ? void 0 : _m.fetch,
856
+ logging: this._options.logging,
857
+ });
858
+ if (_response.ok) {
859
+ return {
860
+ data: _response.body,
861
+ rawResponse: _response.rawResponse,
862
+ };
863
+ }
864
+ if (_response.error.reason === "status-code") {
865
+ switch (_response.error.statusCode) {
866
+ case 400:
867
+ throw new AthenaIntelligence.BadRequestError(_response.error.body, _response.rawResponse);
868
+ case 401:
869
+ throw new AthenaIntelligence.UnauthorizedError(_response.error.body, _response.rawResponse);
870
+ case 403:
871
+ throw new AthenaIntelligence.ForbiddenError(_response.error.body, _response.rawResponse);
872
+ case 404:
873
+ throw new AthenaIntelligence.NotFoundError(_response.error.body, _response.rawResponse);
874
+ case 410:
875
+ throw new AthenaIntelligence.GoneError(_response.error.body, _response.rawResponse);
876
+ case 413:
877
+ throw new AthenaIntelligence.ContentTooLargeError(_response.error.body, _response.rawResponse);
878
+ case 422:
879
+ throw new AthenaIntelligence.UnprocessableEntityError(_response.error.body, _response.rawResponse);
880
+ case 502:
881
+ throw new AthenaIntelligence.BadGatewayError(_response.error.body, _response.rawResponse);
882
+ case 503:
883
+ throw new AthenaIntelligence.ServiceUnavailableError(_response.error.body, _response.rawResponse);
884
+ default:
885
+ throw new errors.AthenaIntelligenceError({
886
+ statusCode: _response.error.statusCode,
887
+ body: _response.error.body,
888
+ rawResponse: _response.rawResponse,
889
+ });
890
+ }
891
+ }
892
+ switch (_response.error.reason) {
893
+ case "non-json":
894
+ throw new errors.AthenaIntelligenceError({
895
+ statusCode: _response.error.statusCode,
896
+ body: _response.error.rawBody,
897
+ rawResponse: _response.rawResponse,
898
+ });
899
+ case "body-is-null":
900
+ throw new errors.AthenaIntelligenceError({
901
+ statusCode: _response.error.statusCode,
902
+ rawResponse: _response.rawResponse,
903
+ });
904
+ case "timeout":
905
+ throw new errors.AthenaIntelligenceTimeoutError("Timeout exceeded when calling PUT /api/v0/assets/upload-links/{link_id}.");
906
+ case "unknown":
907
+ throw new errors.AthenaIntelligenceError({
908
+ message: _response.error.errorMessage,
909
+ rawResponse: _response.rawResponse,
910
+ });
911
+ }
912
+ });
913
+ }
727
914
  /**
728
915
  * Retrieve a single asset by its ID. Returns comprehensive metadata including creation info, tags, timestamps, media type, and AI-generated summary.
729
916
  *
@@ -0,0 +1,18 @@
1
+ /**
2
+ * @example
3
+ * {
4
+ * file_name: "notes.md",
5
+ * parent_folder_id: "asset_folder_12345",
6
+ * title: "Quarterly notes"
7
+ * }
8
+ */
9
+ export interface CreateUploadLinkRequestIn {
10
+ /** The name of the file you will send, which decides what it becomes, as in POST /api/v0/assets/create-from-file: a .md, .markdown, .txt or .text file an Athena document, a .html or .htm file a user interface, a .docx file a Word document and a .pptx or .potx file a presentation */
11
+ file_name: string;
12
+ /** Folder to put the new asset in; you need EDIT on it */
13
+ parent_folder_id?: string | null;
14
+ /** Title for the new asset; defaults to the file's name */
15
+ title?: string | null;
16
+ /** Workspace to create the asset in; defaults to parent_folder_id's, else your current one */
17
+ workspace_id?: string | null;
18
+ }
@@ -0,0 +1,3 @@
1
+ "use strict";
2
+ // This file was auto-generated by Fern from our API Definition.
3
+ Object.defineProperty(exports, "__esModule", { value: true });
@@ -7,6 +7,7 @@ export type { ConvertToUserInterfaceAssetsRequest } from "./ConvertToUserInterfa
7
7
  export type { CreateAssetRequestIn } from "./CreateAssetRequestIn.js";
8
8
  export type { CreateProjectRequestIn } from "./CreateProjectRequestIn.js";
9
9
  export type { CreateStudioTokenAssetsRequest } from "./CreateStudioTokenAssetsRequest.js";
10
+ export type { CreateUploadLinkRequestIn } from "./CreateUploadLinkRequestIn.js";
10
11
  export type { DownloadAssetsRequest } from "./DownloadAssetsRequest.js";
11
12
  export type { DuplicateAssetRequestIn } from "./DuplicateAssetRequestIn.js";
12
13
  export type { GetAccessAssetsRequest } from "./GetAccessAssetsRequest.js";
@@ -0,0 +1,30 @@
1
+ /**
2
+ * A one-time link that takes one file, sent without an API key.
3
+ */
4
+ export interface UploadLinkResponseOut {
5
+ /** What the file becomes */
6
+ asset_type: string;
7
+ /** A curl command that sends the file, every argument shell-quoted; replace the path placeholder with your file's path. It prints the new asset as JSON */
8
+ curl: string;
9
+ /** When the link stops working (UTC) */
10
+ expires_at: string;
11
+ /** The file the link takes */
12
+ file_name: string;
13
+ /** Headers the upload must carry: X-Athena-Upload-Token, the link's one-time credential. It works once, until expires_at */
14
+ headers: Record<string, string>;
15
+ /** ID of the link */
16
+ link_id: string;
17
+ /** The largest file the link takes */
18
+ max_bytes: number;
19
+ /** The HTTP method the upload uses */
20
+ method?: UploadLinkResponseOut.Method;
21
+ /** Where to send the file: one PUT, its body the file's bytes */
22
+ upload_url: string;
23
+ }
24
+ export declare namespace UploadLinkResponseOut {
25
+ /** The HTTP method the upload uses */
26
+ const Method: {
27
+ readonly Put: "PUT";
28
+ };
29
+ type Method = (typeof Method)[keyof typeof Method];
30
+ }
@@ -0,0 +1,11 @@
1
+ "use strict";
2
+ // This file was auto-generated by Fern from our API Definition.
3
+ Object.defineProperty(exports, "__esModule", { value: true });
4
+ exports.UploadLinkResponseOut = void 0;
5
+ var UploadLinkResponseOut;
6
+ (function (UploadLinkResponseOut) {
7
+ /** The HTTP method the upload uses */
8
+ UploadLinkResponseOut.Method = {
9
+ Put: "PUT",
10
+ };
11
+ })(UploadLinkResponseOut || (exports.UploadLinkResponseOut = UploadLinkResponseOut = {}));
@@ -169,6 +169,7 @@ export * from "./ToolUseContent.js";
169
169
  export * from "./UpdateAssetConfigResponseOut.js";
170
170
  export * from "./UpdateWorkspaceDisclaimerIn.js";
171
171
  export * from "./UpdateWorkspaceToolRegistryToolIn.js";
172
+ export * from "./UploadLinkResponseOut.js";
172
173
  export * from "./UserInfoOut.js";
173
174
  export * from "./WorkspaceAccessResponseOut.js";
174
175
  export * from "./WorkspaceConfigurationResponseOut.js";
@@ -185,6 +185,7 @@ __exportStar(require("./ToolUseContent.js"), exports);
185
185
  __exportStar(require("./UpdateAssetConfigResponseOut.js"), exports);
186
186
  __exportStar(require("./UpdateWorkspaceDisclaimerIn.js"), exports);
187
187
  __exportStar(require("./UpdateWorkspaceToolRegistryToolIn.js"), exports);
188
+ __exportStar(require("./UploadLinkResponseOut.js"), exports);
188
189
  __exportStar(require("./UserInfoOut.js"), exports);
189
190
  __exportStar(require("./WorkspaceAccessResponseOut.js"), exports);
190
191
  __exportStar(require("./WorkspaceConfigurationResponseOut.js"), exports);
@@ -1 +1 @@
1
- export declare const SDK_VERSION = "4.3.2298";
1
+ export declare const SDK_VERSION = "4.3.2299";
@@ -1,4 +1,4 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.SDK_VERSION = void 0;
4
- exports.SDK_VERSION = "4.3.2298";
4
+ exports.SDK_VERSION = "4.3.2299";
@@ -6,8 +6,8 @@ export function normalizeClientOptions(options) {
6
6
  const headers = mergeHeaders({
7
7
  "X-Fern-Language": "JavaScript",
8
8
  "X-Fern-SDK-Name": "@athenaintel/sdk",
9
- "X-Fern-SDK-Version": "4.3.2298",
10
- "User-Agent": "@athenaintel/sdk/4.3.2298",
9
+ "X-Fern-SDK-Version": "4.3.2299",
10
+ "User-Agent": "@athenaintel/sdk/4.3.2299",
11
11
  "X-Fern-Runtime": core.RUNTIME.type,
12
12
  "X-Fern-Runtime-Version": core.RUNTIME.version,
13
13
  "X-Athena-Session-Credential": options === null || options === void 0 ? void 0 : options.sessionCredential,
@@ -157,6 +157,45 @@ export declare class AssetsClient {
157
157
  */
158
158
  duplicate(request: AthenaIntelligence.DuplicateAssetRequestIn, requestOptions?: AssetsClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.DuplicateAssetResponseOut>;
159
159
  private __duplicate;
160
+ /**
161
+ * Mint a one-time link that takes one file without an API key, for a caller that can run a shell command but holds no key, such as an agent connected through an Athena MCP server. The file's name decides what it becomes, as with POST /api/v0/assets/create-from-file: a .md, .markdown, .txt or .text file an Athena document, a .html or .htm file a user interface, a .docx file a Word document and a .pptx or .potx file a presentation. The gates of create-from-file run now (membership in the workspace, EDIT on parent_folder_id, the deployment's offering, an agent run's tool policy) and again when the file arrives. Send the file's bytes as the body of one PUT to upload_url with the X-Athena-Upload-Token header (the curl field is that command); its answer is the new asset. A link works once, for 15 minutes.
162
+ *
163
+ * @param {AthenaIntelligence.CreateUploadLinkRequestIn} request
164
+ * @param {AssetsClient.RequestOptions} requestOptions - Request-specific configuration.
165
+ *
166
+ * @throws {@link AthenaIntelligence.ForbiddenError}
167
+ * @throws {@link AthenaIntelligence.NotFoundError}
168
+ * @throws {@link AthenaIntelligence.UnprocessableEntityError}
169
+ * @throws {@link AthenaIntelligence.ServiceUnavailableError}
170
+ *
171
+ * @example
172
+ * await client.assets.createUploadLink({
173
+ * file_name: "notes.md",
174
+ * parent_folder_id: "asset_folder_12345",
175
+ * title: "Quarterly notes"
176
+ * })
177
+ */
178
+ createUploadLink(request: AthenaIntelligence.CreateUploadLinkRequestIn, requestOptions?: AssetsClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.UploadLinkResponseOut>;
179
+ private __createUploadLink;
180
+ /**
181
+ * Send one file through a link from POST /api/v0/assets/upload-links: the body is the file's bytes and X-Athena-Upload-Token the link's credential; no API key is needed. Athena runs POST /api/v0/assets/create-from-file as the person who asked for the link, with every gate again (an agent run's tool policy included), and answers with the new asset. A link works once: the first upload spends it, whatever its answer.
182
+ *
183
+ * @param {core.file.Uploadable} uploadable
184
+ * @param {string} link_id
185
+ * @param {AssetsClient.RequestOptions} requestOptions - Request-specific configuration.
186
+ *
187
+ * @throws {@link AthenaIntelligence.BadRequestError}
188
+ * @throws {@link AthenaIntelligence.UnauthorizedError}
189
+ * @throws {@link AthenaIntelligence.ForbiddenError}
190
+ * @throws {@link AthenaIntelligence.NotFoundError}
191
+ * @throws {@link AthenaIntelligence.GoneError}
192
+ * @throws {@link AthenaIntelligence.ContentTooLargeError}
193
+ * @throws {@link AthenaIntelligence.UnprocessableEntityError}
194
+ * @throws {@link AthenaIntelligence.BadGatewayError}
195
+ * @throws {@link AthenaIntelligence.ServiceUnavailableError}
196
+ */
197
+ uploadThroughLink(uploadable: core.file.Uploadable, link_id: string, requestOptions?: AssetsClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.CreateAssetResponseOut>;
198
+ private __uploadThroughLink;
160
199
  /**
161
200
  * Retrieve a single asset by its ID. Returns comprehensive metadata including creation info, tags, timestamps, media type, and AI-generated summary.
162
201
  *
@@ -688,6 +688,193 @@ export class AssetsClient {
688
688
  }
689
689
  });
690
690
  }
691
+ /**
692
+ * Mint a one-time link that takes one file without an API key, for a caller that can run a shell command but holds no key, such as an agent connected through an Athena MCP server. The file's name decides what it becomes, as with POST /api/v0/assets/create-from-file: a .md, .markdown, .txt or .text file an Athena document, a .html or .htm file a user interface, a .docx file a Word document and a .pptx or .potx file a presentation. The gates of create-from-file run now (membership in the workspace, EDIT on parent_folder_id, the deployment's offering, an agent run's tool policy) and again when the file arrives. Send the file's bytes as the body of one PUT to upload_url with the X-Athena-Upload-Token header (the curl field is that command); its answer is the new asset. A link works once, for 15 minutes.
693
+ *
694
+ * @param {AthenaIntelligence.CreateUploadLinkRequestIn} request
695
+ * @param {AssetsClient.RequestOptions} requestOptions - Request-specific configuration.
696
+ *
697
+ * @throws {@link AthenaIntelligence.ForbiddenError}
698
+ * @throws {@link AthenaIntelligence.NotFoundError}
699
+ * @throws {@link AthenaIntelligence.UnprocessableEntityError}
700
+ * @throws {@link AthenaIntelligence.ServiceUnavailableError}
701
+ *
702
+ * @example
703
+ * await client.assets.createUploadLink({
704
+ * file_name: "notes.md",
705
+ * parent_folder_id: "asset_folder_12345",
706
+ * title: "Quarterly notes"
707
+ * })
708
+ */
709
+ createUploadLink(request, requestOptions) {
710
+ return core.HttpResponsePromise.fromPromise(this.__createUploadLink(request, requestOptions));
711
+ }
712
+ __createUploadLink(request, requestOptions) {
713
+ return __awaiter(this, void 0, void 0, function* () {
714
+ var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
715
+ const _authRequest = yield this._options.authProvider.getAuthRequest();
716
+ const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({
717
+ "X-Athena-Session-Credential": (_b = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.sessionCredential) !== null && _b !== void 0 ? _b : (_c = this._options) === null || _c === void 0 ? void 0 : _c.sessionCredential,
718
+ }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
719
+ const _response = yield ((_d = this._options.fetcher) !== null && _d !== void 0 ? _d : core.fetcher)({
720
+ url: core.url.join((_f = (_e = (yield core.Supplier.get(this._options.baseUrl))) !== null && _e !== void 0 ? _e : (yield core.Supplier.get(this._options.environment))) !== null && _f !== void 0 ? _f : environments.AthenaIntelligenceEnvironment.Production, "api/v0/assets/upload-links"),
721
+ method: "POST",
722
+ headers: _headers,
723
+ contentType: "application/json",
724
+ queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
725
+ requestType: "json",
726
+ body: request,
727
+ 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,
728
+ 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,
729
+ abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
730
+ fetchFn: (_m = this._options) === null || _m === void 0 ? void 0 : _m.fetch,
731
+ logging: this._options.logging,
732
+ });
733
+ if (_response.ok) {
734
+ return {
735
+ data: _response.body,
736
+ rawResponse: _response.rawResponse,
737
+ };
738
+ }
739
+ if (_response.error.reason === "status-code") {
740
+ switch (_response.error.statusCode) {
741
+ case 403:
742
+ throw new AthenaIntelligence.ForbiddenError(_response.error.body, _response.rawResponse);
743
+ case 404:
744
+ throw new AthenaIntelligence.NotFoundError(_response.error.body, _response.rawResponse);
745
+ case 422:
746
+ throw new AthenaIntelligence.UnprocessableEntityError(_response.error.body, _response.rawResponse);
747
+ case 503:
748
+ throw new AthenaIntelligence.ServiceUnavailableError(_response.error.body, _response.rawResponse);
749
+ default:
750
+ throw new errors.AthenaIntelligenceError({
751
+ statusCode: _response.error.statusCode,
752
+ body: _response.error.body,
753
+ rawResponse: _response.rawResponse,
754
+ });
755
+ }
756
+ }
757
+ switch (_response.error.reason) {
758
+ case "non-json":
759
+ throw new errors.AthenaIntelligenceError({
760
+ statusCode: _response.error.statusCode,
761
+ body: _response.error.rawBody,
762
+ rawResponse: _response.rawResponse,
763
+ });
764
+ case "body-is-null":
765
+ throw new errors.AthenaIntelligenceError({
766
+ statusCode: _response.error.statusCode,
767
+ rawResponse: _response.rawResponse,
768
+ });
769
+ case "timeout":
770
+ throw new errors.AthenaIntelligenceTimeoutError("Timeout exceeded when calling POST /api/v0/assets/upload-links.");
771
+ case "unknown":
772
+ throw new errors.AthenaIntelligenceError({
773
+ message: _response.error.errorMessage,
774
+ rawResponse: _response.rawResponse,
775
+ });
776
+ }
777
+ });
778
+ }
779
+ /**
780
+ * Send one file through a link from POST /api/v0/assets/upload-links: the body is the file's bytes and X-Athena-Upload-Token the link's credential; no API key is needed. Athena runs POST /api/v0/assets/create-from-file as the person who asked for the link, with every gate again (an agent run's tool policy included), and answers with the new asset. A link works once: the first upload spends it, whatever its answer.
781
+ *
782
+ * @param {core.file.Uploadable} uploadable
783
+ * @param {string} link_id
784
+ * @param {AssetsClient.RequestOptions} requestOptions - Request-specific configuration.
785
+ *
786
+ * @throws {@link AthenaIntelligence.BadRequestError}
787
+ * @throws {@link AthenaIntelligence.UnauthorizedError}
788
+ * @throws {@link AthenaIntelligence.ForbiddenError}
789
+ * @throws {@link AthenaIntelligence.NotFoundError}
790
+ * @throws {@link AthenaIntelligence.GoneError}
791
+ * @throws {@link AthenaIntelligence.ContentTooLargeError}
792
+ * @throws {@link AthenaIntelligence.UnprocessableEntityError}
793
+ * @throws {@link AthenaIntelligence.BadGatewayError}
794
+ * @throws {@link AthenaIntelligence.ServiceUnavailableError}
795
+ */
796
+ uploadThroughLink(uploadable, link_id, requestOptions) {
797
+ return core.HttpResponsePromise.fromPromise(this.__uploadThroughLink(uploadable, link_id, requestOptions));
798
+ }
799
+ __uploadThroughLink(uploadable, link_id, requestOptions) {
800
+ return __awaiter(this, void 0, void 0, function* () {
801
+ var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
802
+ const _binaryUploadRequest = yield core.file.toBinaryUploadRequest(uploadable);
803
+ const _authRequest = yield this._options.authProvider.getAuthRequest();
804
+ const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({
805
+ "X-Athena-Session-Credential": (_b = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.sessionCredential) !== null && _b !== void 0 ? _b : (_c = this._options) === null || _c === void 0 ? void 0 : _c.sessionCredential,
806
+ }), _binaryUploadRequest.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
807
+ const _response = yield ((_d = this._options.fetcher) !== null && _d !== void 0 ? _d : core.fetcher)({
808
+ url: core.url.join((_f = (_e = (yield core.Supplier.get(this._options.baseUrl))) !== null && _e !== void 0 ? _e : (yield core.Supplier.get(this._options.environment))) !== null && _f !== void 0 ? _f : environments.AthenaIntelligenceEnvironment.Production, `api/v0/assets/upload-links/${core.url.encodePathParam(link_id)}`),
809
+ method: "PUT",
810
+ headers: _headers,
811
+ contentType: "application/octet-stream",
812
+ queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
813
+ requestType: "bytes",
814
+ duplex: "half",
815
+ body: _binaryUploadRequest.body,
816
+ 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,
817
+ 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,
818
+ abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
819
+ fetchFn: (_m = this._options) === null || _m === void 0 ? void 0 : _m.fetch,
820
+ logging: this._options.logging,
821
+ });
822
+ if (_response.ok) {
823
+ return {
824
+ data: _response.body,
825
+ rawResponse: _response.rawResponse,
826
+ };
827
+ }
828
+ if (_response.error.reason === "status-code") {
829
+ switch (_response.error.statusCode) {
830
+ case 400:
831
+ throw new AthenaIntelligence.BadRequestError(_response.error.body, _response.rawResponse);
832
+ case 401:
833
+ throw new AthenaIntelligence.UnauthorizedError(_response.error.body, _response.rawResponse);
834
+ case 403:
835
+ throw new AthenaIntelligence.ForbiddenError(_response.error.body, _response.rawResponse);
836
+ case 404:
837
+ throw new AthenaIntelligence.NotFoundError(_response.error.body, _response.rawResponse);
838
+ case 410:
839
+ throw new AthenaIntelligence.GoneError(_response.error.body, _response.rawResponse);
840
+ case 413:
841
+ throw new AthenaIntelligence.ContentTooLargeError(_response.error.body, _response.rawResponse);
842
+ case 422:
843
+ throw new AthenaIntelligence.UnprocessableEntityError(_response.error.body, _response.rawResponse);
844
+ case 502:
845
+ throw new AthenaIntelligence.BadGatewayError(_response.error.body, _response.rawResponse);
846
+ case 503:
847
+ throw new AthenaIntelligence.ServiceUnavailableError(_response.error.body, _response.rawResponse);
848
+ default:
849
+ throw new errors.AthenaIntelligenceError({
850
+ statusCode: _response.error.statusCode,
851
+ body: _response.error.body,
852
+ rawResponse: _response.rawResponse,
853
+ });
854
+ }
855
+ }
856
+ switch (_response.error.reason) {
857
+ case "non-json":
858
+ throw new errors.AthenaIntelligenceError({
859
+ statusCode: _response.error.statusCode,
860
+ body: _response.error.rawBody,
861
+ rawResponse: _response.rawResponse,
862
+ });
863
+ case "body-is-null":
864
+ throw new errors.AthenaIntelligenceError({
865
+ statusCode: _response.error.statusCode,
866
+ rawResponse: _response.rawResponse,
867
+ });
868
+ case "timeout":
869
+ throw new errors.AthenaIntelligenceTimeoutError("Timeout exceeded when calling PUT /api/v0/assets/upload-links/{link_id}.");
870
+ case "unknown":
871
+ throw new errors.AthenaIntelligenceError({
872
+ message: _response.error.errorMessage,
873
+ rawResponse: _response.rawResponse,
874
+ });
875
+ }
876
+ });
877
+ }
691
878
  /**
692
879
  * Retrieve a single asset by its ID. Returns comprehensive metadata including creation info, tags, timestamps, media type, and AI-generated summary.
693
880
  *
@@ -0,0 +1,18 @@
1
+ /**
2
+ * @example
3
+ * {
4
+ * file_name: "notes.md",
5
+ * parent_folder_id: "asset_folder_12345",
6
+ * title: "Quarterly notes"
7
+ * }
8
+ */
9
+ export interface CreateUploadLinkRequestIn {
10
+ /** The name of the file you will send, which decides what it becomes, as in POST /api/v0/assets/create-from-file: a .md, .markdown, .txt or .text file an Athena document, a .html or .htm file a user interface, a .docx file a Word document and a .pptx or .potx file a presentation */
11
+ file_name: string;
12
+ /** Folder to put the new asset in; you need EDIT on it */
13
+ parent_folder_id?: string | null;
14
+ /** Title for the new asset; defaults to the file's name */
15
+ title?: string | null;
16
+ /** Workspace to create the asset in; defaults to parent_folder_id's, else your current one */
17
+ workspace_id?: string | null;
18
+ }
@@ -0,0 +1,2 @@
1
+ // This file was auto-generated by Fern from our API Definition.
2
+ export {};
@@ -7,6 +7,7 @@ export type { ConvertToUserInterfaceAssetsRequest } from "./ConvertToUserInterfa
7
7
  export type { CreateAssetRequestIn } from "./CreateAssetRequestIn.mjs";
8
8
  export type { CreateProjectRequestIn } from "./CreateProjectRequestIn.mjs";
9
9
  export type { CreateStudioTokenAssetsRequest } from "./CreateStudioTokenAssetsRequest.mjs";
10
+ export type { CreateUploadLinkRequestIn } from "./CreateUploadLinkRequestIn.mjs";
10
11
  export type { DownloadAssetsRequest } from "./DownloadAssetsRequest.mjs";
11
12
  export type { DuplicateAssetRequestIn } from "./DuplicateAssetRequestIn.mjs";
12
13
  export type { GetAccessAssetsRequest } from "./GetAccessAssetsRequest.mjs";
@@ -0,0 +1,30 @@
1
+ /**
2
+ * A one-time link that takes one file, sent without an API key.
3
+ */
4
+ export interface UploadLinkResponseOut {
5
+ /** What the file becomes */
6
+ asset_type: string;
7
+ /** A curl command that sends the file, every argument shell-quoted; replace the path placeholder with your file's path. It prints the new asset as JSON */
8
+ curl: string;
9
+ /** When the link stops working (UTC) */
10
+ expires_at: string;
11
+ /** The file the link takes */
12
+ file_name: string;
13
+ /** Headers the upload must carry: X-Athena-Upload-Token, the link's one-time credential. It works once, until expires_at */
14
+ headers: Record<string, string>;
15
+ /** ID of the link */
16
+ link_id: string;
17
+ /** The largest file the link takes */
18
+ max_bytes: number;
19
+ /** The HTTP method the upload uses */
20
+ method?: UploadLinkResponseOut.Method;
21
+ /** Where to send the file: one PUT, its body the file's bytes */
22
+ upload_url: string;
23
+ }
24
+ export declare namespace UploadLinkResponseOut {
25
+ /** The HTTP method the upload uses */
26
+ const Method: {
27
+ readonly Put: "PUT";
28
+ };
29
+ type Method = (typeof Method)[keyof typeof Method];
30
+ }
@@ -0,0 +1,8 @@
1
+ // This file was auto-generated by Fern from our API Definition.
2
+ export var UploadLinkResponseOut;
3
+ (function (UploadLinkResponseOut) {
4
+ /** The HTTP method the upload uses */
5
+ UploadLinkResponseOut.Method = {
6
+ Put: "PUT",
7
+ };
8
+ })(UploadLinkResponseOut || (UploadLinkResponseOut = {}));
@@ -169,6 +169,7 @@ export * from "./ToolUseContent.mjs";
169
169
  export * from "./UpdateAssetConfigResponseOut.mjs";
170
170
  export * from "./UpdateWorkspaceDisclaimerIn.mjs";
171
171
  export * from "./UpdateWorkspaceToolRegistryToolIn.mjs";
172
+ export * from "./UploadLinkResponseOut.mjs";
172
173
  export * from "./UserInfoOut.mjs";
173
174
  export * from "./WorkspaceAccessResponseOut.mjs";
174
175
  export * from "./WorkspaceConfigurationResponseOut.mjs";
@@ -169,6 +169,7 @@ export * from "./ToolUseContent.mjs";
169
169
  export * from "./UpdateAssetConfigResponseOut.mjs";
170
170
  export * from "./UpdateWorkspaceDisclaimerIn.mjs";
171
171
  export * from "./UpdateWorkspaceToolRegistryToolIn.mjs";
172
+ export * from "./UploadLinkResponseOut.mjs";
172
173
  export * from "./UserInfoOut.mjs";
173
174
  export * from "./WorkspaceAccessResponseOut.mjs";
174
175
  export * from "./WorkspaceConfigurationResponseOut.mjs";
@@ -1 +1 @@
1
- export declare const SDK_VERSION = "4.3.2298";
1
+ export declare const SDK_VERSION = "4.3.2299";
@@ -1 +1 @@
1
- export const SDK_VERSION = "4.3.2298";
1
+ export const SDK_VERSION = "4.3.2299";
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@athenaintel/sdk",
3
- "version": "4.3.2298",
3
+ "version": "4.3.2299",
4
4
  "private": false,
5
5
  "repository": "github:Athena-Intel/athena-typescript",
6
6
  "type": "commonjs",
package/reference.md CHANGED
@@ -962,6 +962,73 @@ await client.assets.duplicate({
962
962
  </dl>
963
963
 
964
964
 
965
+ </dd>
966
+ </dl>
967
+ </details>
968
+
969
+ <details><summary><code>client.assets.<a href="/src/api/resources/assets/client/Client.ts">createUploadLink</a>({ ...params }) -> AthenaIntelligence.UploadLinkResponseOut</code></summary>
970
+ <dl>
971
+ <dd>
972
+
973
+ #### 📝 Description
974
+
975
+ <dl>
976
+ <dd>
977
+
978
+ <dl>
979
+ <dd>
980
+
981
+ Mint a one-time link that takes one file without an API key, for a caller that can run a shell command but holds no key, such as an agent connected through an Athena MCP server. The file's name decides what it becomes, as with POST /api/v0/assets/create-from-file: a .md, .markdown, .txt or .text file an Athena document, a .html or .htm file a user interface, a .docx file a Word document and a .pptx or .potx file a presentation. The gates of create-from-file run now (membership in the workspace, EDIT on parent_folder_id, the deployment's offering, an agent run's tool policy) and again when the file arrives. Send the file's bytes as the body of one PUT to upload_url with the X-Athena-Upload-Token header (the curl field is that command); its answer is the new asset. A link works once, for 15 minutes.
982
+ </dd>
983
+ </dl>
984
+ </dd>
985
+ </dl>
986
+
987
+ #### 🔌 Usage
988
+
989
+ <dl>
990
+ <dd>
991
+
992
+ <dl>
993
+ <dd>
994
+
995
+ ```typescript
996
+ await client.assets.createUploadLink({
997
+ file_name: "notes.md",
998
+ parent_folder_id: "asset_folder_12345",
999
+ title: "Quarterly notes"
1000
+ });
1001
+
1002
+ ```
1003
+ </dd>
1004
+ </dl>
1005
+ </dd>
1006
+ </dl>
1007
+
1008
+ #### ⚙️ Parameters
1009
+
1010
+ <dl>
1011
+ <dd>
1012
+
1013
+ <dl>
1014
+ <dd>
1015
+
1016
+ **request:** `AthenaIntelligence.CreateUploadLinkRequestIn`
1017
+
1018
+ </dd>
1019
+ </dl>
1020
+
1021
+ <dl>
1022
+ <dd>
1023
+
1024
+ **requestOptions:** `AssetsClient.RequestOptions`
1025
+
1026
+ </dd>
1027
+ </dl>
1028
+ </dd>
1029
+ </dl>
1030
+
1031
+
965
1032
  </dd>
966
1033
  </dl>
967
1034
  </details>