@athenaintel/sdk 4.3.2298 → 4.3.2300
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.
- package/dist/cjs/BaseClient.js +2 -2
- package/dist/cjs/api/resources/assets/client/Client.d.ts +39 -0
- package/dist/cjs/api/resources/assets/client/Client.js +187 -0
- package/dist/cjs/api/resources/assets/client/requests/CreateUploadLinkRequestIn.d.ts +18 -0
- package/dist/cjs/api/resources/assets/client/requests/CreateUploadLinkRequestIn.js +3 -0
- package/dist/cjs/api/resources/assets/client/requests/index.d.ts +1 -0
- package/dist/cjs/api/types/UploadLinkResponseOut.d.ts +30 -0
- package/dist/cjs/api/types/UploadLinkResponseOut.js +11 -0
- package/dist/cjs/api/types/index.d.ts +1 -0
- package/dist/cjs/api/types/index.js +1 -0
- package/dist/cjs/version.d.ts +1 -1
- package/dist/cjs/version.js +1 -1
- package/dist/esm/BaseClient.mjs +2 -2
- package/dist/esm/api/resources/assets/client/Client.d.mts +39 -0
- package/dist/esm/api/resources/assets/client/Client.mjs +187 -0
- package/dist/esm/api/resources/assets/client/requests/CreateUploadLinkRequestIn.d.mts +18 -0
- package/dist/esm/api/resources/assets/client/requests/CreateUploadLinkRequestIn.mjs +2 -0
- package/dist/esm/api/resources/assets/client/requests/index.d.mts +1 -0
- package/dist/esm/api/types/UploadLinkResponseOut.d.mts +30 -0
- package/dist/esm/api/types/UploadLinkResponseOut.mjs +8 -0
- package/dist/esm/api/types/index.d.mts +1 -0
- package/dist/esm/api/types/index.mjs +1 -0
- package/dist/esm/version.d.mts +1 -1
- package/dist/esm/version.mjs +1 -1
- package/package.json +1 -1
- package/reference.md +67 -0
package/dist/cjs/BaseClient.js
CHANGED
|
@@ -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.
|
|
47
|
-
"User-Agent": "@athenaintel/sdk/4.3.
|
|
46
|
+
"X-Fern-SDK-Version": "4.3.2300",
|
|
47
|
+
"User-Agent": "@athenaintel/sdk/4.3.2300",
|
|
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
|
+
}
|
|
@@ -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);
|
package/dist/cjs/version.d.ts
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
export declare const SDK_VERSION = "4.3.
|
|
1
|
+
export declare const SDK_VERSION = "4.3.2300";
|
package/dist/cjs/version.js
CHANGED
package/dist/esm/BaseClient.mjs
CHANGED
|
@@ -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.
|
|
10
|
-
"User-Agent": "@athenaintel/sdk/4.3.
|
|
9
|
+
"X-Fern-SDK-Version": "4.3.2300",
|
|
10
|
+
"User-Agent": "@athenaintel/sdk/4.3.2300",
|
|
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
|
+
}
|
|
@@ -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";
|
package/dist/esm/version.d.mts
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
export declare const SDK_VERSION = "4.3.
|
|
1
|
+
export declare const SDK_VERSION = "4.3.2300";
|
package/dist/esm/version.mjs
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
export const SDK_VERSION = "4.3.
|
|
1
|
+
export const SDK_VERSION = "4.3.2300";
|
package/package.json
CHANGED
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>
|