@athenaintel/sdk 4.3.2267 → 4.3.2269

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.
Files changed (44) hide show
  1. package/dist/cjs/BaseClient.js +2 -2
  2. package/dist/cjs/api/resources/assets/client/Client.d.ts +22 -0
  3. package/dist/cjs/api/resources/assets/client/Client.js +93 -0
  4. package/dist/cjs/api/resources/assets/client/requests/CreateStudioTokenAssetsRequest.d.ts +15 -0
  5. package/dist/cjs/api/resources/assets/client/requests/CreateStudioTokenAssetsRequest.js +3 -0
  6. package/dist/cjs/api/resources/assets/client/requests/index.d.ts +1 -0
  7. package/dist/cjs/api/resources/tools/resources/email/client/Client.d.ts +24 -0
  8. package/dist/cjs/api/resources/tools/resources/email/client/Client.js +98 -0
  9. package/dist/cjs/api/resources/tools/resources/email/client/requests/GetMessageEmailRequest.d.ts +12 -0
  10. package/dist/cjs/api/resources/tools/resources/email/client/requests/GetMessageEmailRequest.js +3 -0
  11. package/dist/cjs/api/resources/tools/resources/email/client/requests/index.d.ts +1 -0
  12. package/dist/cjs/api/types/EmailMessageResponseOut.d.ts +33 -0
  13. package/dist/cjs/api/types/EmailMessageResponseOut.js +3 -0
  14. package/dist/cjs/api/types/StudioTokenRequestIn.d.ts +15 -0
  15. package/dist/cjs/api/types/StudioTokenRequestIn.js +12 -0
  16. package/dist/cjs/api/types/StudioTokenResponseOut.d.ts +32 -0
  17. package/dist/cjs/api/types/StudioTokenResponseOut.js +18 -0
  18. package/dist/cjs/api/types/index.d.ts +3 -0
  19. package/dist/cjs/api/types/index.js +3 -0
  20. package/dist/cjs/version.d.ts +1 -1
  21. package/dist/cjs/version.js +1 -1
  22. package/dist/esm/BaseClient.mjs +2 -2
  23. package/dist/esm/api/resources/assets/client/Client.d.mts +22 -0
  24. package/dist/esm/api/resources/assets/client/Client.mjs +93 -0
  25. package/dist/esm/api/resources/assets/client/requests/CreateStudioTokenAssetsRequest.d.mts +15 -0
  26. package/dist/esm/api/resources/assets/client/requests/CreateStudioTokenAssetsRequest.mjs +2 -0
  27. package/dist/esm/api/resources/assets/client/requests/index.d.mts +1 -0
  28. package/dist/esm/api/resources/tools/resources/email/client/Client.d.mts +24 -0
  29. package/dist/esm/api/resources/tools/resources/email/client/Client.mjs +98 -0
  30. package/dist/esm/api/resources/tools/resources/email/client/requests/GetMessageEmailRequest.d.mts +12 -0
  31. package/dist/esm/api/resources/tools/resources/email/client/requests/GetMessageEmailRequest.mjs +2 -0
  32. package/dist/esm/api/resources/tools/resources/email/client/requests/index.d.mts +1 -0
  33. package/dist/esm/api/types/EmailMessageResponseOut.d.mts +33 -0
  34. package/dist/esm/api/types/EmailMessageResponseOut.mjs +2 -0
  35. package/dist/esm/api/types/StudioTokenRequestIn.d.mts +15 -0
  36. package/dist/esm/api/types/StudioTokenRequestIn.mjs +9 -0
  37. package/dist/esm/api/types/StudioTokenResponseOut.d.mts +32 -0
  38. package/dist/esm/api/types/StudioTokenResponseOut.mjs +15 -0
  39. package/dist/esm/api/types/index.d.mts +3 -0
  40. package/dist/esm/api/types/index.mjs +3 -0
  41. package/dist/esm/version.d.mts +1 -1
  42. package/dist/esm/version.mjs +1 -1
  43. package/package.json +1 -1
  44. package/reference.md +137 -0
@@ -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.2267",
47
- "User-Agent": "@athenaintel/sdk/4.3.2267",
46
+ "X-Fern-SDK-Version": "4.3.2269",
47
+ "User-Agent": "@athenaintel/sdk/4.3.2269",
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,
@@ -413,6 +413,28 @@ export declare class AssetsClient {
413
413
  */
414
414
  updateSkillConfig(request: AthenaIntelligence.UpdateSkillConfigRequestIn, requestOptions?: AssetsClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.UpdateAssetConfigResponseOut>;
415
415
  private __updateSkillConfig;
416
+ /**
417
+ * Mint a short-lived asset token for the service that edits an asset: a spreadsheet's, a Word document's or a deck's, named in ``audience``. The token names the caller, this asset and one access level, lasts 15 minutes and is good only on that service's routes for this asset, so code (an SDK in a computer, for example) never sends the service a long-lived credential. The caller must be able to view the asset and be a member of its workspace; the token is read-write only when the caller can edit the asset and asked for edit. A computer's or session's credential mints tokens for assets of its own workspace only. Any other asset (another type, a live provider file, or one outside every workspace) is refused with 422.
418
+ *
419
+ * @param {AthenaIntelligence.CreateStudioTokenAssetsRequest} request
420
+ * @param {AssetsClient.RequestOptions} requestOptions - Request-specific configuration.
421
+ *
422
+ * @throws {@link AthenaIntelligence.BadRequestError}
423
+ * @throws {@link AthenaIntelligence.ForbiddenError}
424
+ * @throws {@link AthenaIntelligence.NotFoundError}
425
+ * @throws {@link AthenaIntelligence.UnprocessableEntityError}
426
+ * @throws {@link AthenaIntelligence.ServiceUnavailableError}
427
+ *
428
+ * @example
429
+ * await client.assets.createStudioToken({
430
+ * asset_id: "asset_92492920-d118-42d3-95b4-00eccfe0754f",
431
+ * body: {
432
+ * access: "edit"
433
+ * }
434
+ * })
435
+ */
436
+ createStudioToken(request: AthenaIntelligence.CreateStudioTokenAssetsRequest, requestOptions?: AssetsClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.StudioTokenResponseOut>;
437
+ private __createStudioToken;
416
438
  /**
417
439
  * Update the workspace-level access on an asset. Needs edit access to the asset. Set 'view' or 'edit' to grant workspace-wide access, which also needs permission to share with the workspace. Set 'none' (or null) to remove the workspace-wide share, as DELETE does; removing a folder's share also removes it from the assets inside the folder. People and groups the asset is shared with directly keep their access.
418
440
  *
@@ -1867,6 +1867,99 @@ class AssetsClient {
1867
1867
  }
1868
1868
  });
1869
1869
  }
1870
+ /**
1871
+ * Mint a short-lived asset token for the service that edits an asset: a spreadsheet's, a Word document's or a deck's, named in ``audience``. The token names the caller, this asset and one access level, lasts 15 minutes and is good only on that service's routes for this asset, so code (an SDK in a computer, for example) never sends the service a long-lived credential. The caller must be able to view the asset and be a member of its workspace; the token is read-write only when the caller can edit the asset and asked for edit. A computer's or session's credential mints tokens for assets of its own workspace only. Any other asset (another type, a live provider file, or one outside every workspace) is refused with 422.
1872
+ *
1873
+ * @param {AthenaIntelligence.CreateStudioTokenAssetsRequest} request
1874
+ * @param {AssetsClient.RequestOptions} requestOptions - Request-specific configuration.
1875
+ *
1876
+ * @throws {@link AthenaIntelligence.BadRequestError}
1877
+ * @throws {@link AthenaIntelligence.ForbiddenError}
1878
+ * @throws {@link AthenaIntelligence.NotFoundError}
1879
+ * @throws {@link AthenaIntelligence.UnprocessableEntityError}
1880
+ * @throws {@link AthenaIntelligence.ServiceUnavailableError}
1881
+ *
1882
+ * @example
1883
+ * await client.assets.createStudioToken({
1884
+ * asset_id: "asset_92492920-d118-42d3-95b4-00eccfe0754f",
1885
+ * body: {
1886
+ * access: "edit"
1887
+ * }
1888
+ * })
1889
+ */
1890
+ createStudioToken(request, requestOptions) {
1891
+ return core.HttpResponsePromise.fromPromise(this.__createStudioToken(request, requestOptions));
1892
+ }
1893
+ __createStudioToken(request, requestOptions) {
1894
+ return __awaiter(this, void 0, void 0, function* () {
1895
+ var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
1896
+ const { asset_id: assetId, body: _body } = request;
1897
+ const _authRequest = yield this._options.authProvider.getAuthRequest();
1898
+ 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)({
1899
+ "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,
1900
+ }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
1901
+ const _response = yield ((_d = this._options.fetcher) !== null && _d !== void 0 ? _d : core.fetcher)({
1902
+ 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/${core.url.encodePathParam(assetId)}/studio-token`),
1903
+ method: "POST",
1904
+ headers: _headers,
1905
+ contentType: "application/json",
1906
+ queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
1907
+ requestType: "json",
1908
+ body: _body != null ? _body : undefined,
1909
+ 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,
1910
+ 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,
1911
+ abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
1912
+ fetchFn: (_m = this._options) === null || _m === void 0 ? void 0 : _m.fetch,
1913
+ logging: this._options.logging,
1914
+ });
1915
+ if (_response.ok) {
1916
+ return {
1917
+ data: _response.body,
1918
+ rawResponse: _response.rawResponse,
1919
+ };
1920
+ }
1921
+ if (_response.error.reason === "status-code") {
1922
+ switch (_response.error.statusCode) {
1923
+ case 400:
1924
+ throw new AthenaIntelligence.BadRequestError(_response.error.body, _response.rawResponse);
1925
+ case 403:
1926
+ throw new AthenaIntelligence.ForbiddenError(_response.error.body, _response.rawResponse);
1927
+ case 404:
1928
+ throw new AthenaIntelligence.NotFoundError(_response.error.body, _response.rawResponse);
1929
+ case 422:
1930
+ throw new AthenaIntelligence.UnprocessableEntityError(_response.error.body, _response.rawResponse);
1931
+ case 503:
1932
+ throw new AthenaIntelligence.ServiceUnavailableError(_response.error.body, _response.rawResponse);
1933
+ default:
1934
+ throw new errors.AthenaIntelligenceError({
1935
+ statusCode: _response.error.statusCode,
1936
+ body: _response.error.body,
1937
+ rawResponse: _response.rawResponse,
1938
+ });
1939
+ }
1940
+ }
1941
+ switch (_response.error.reason) {
1942
+ case "non-json":
1943
+ throw new errors.AthenaIntelligenceError({
1944
+ statusCode: _response.error.statusCode,
1945
+ body: _response.error.rawBody,
1946
+ rawResponse: _response.rawResponse,
1947
+ });
1948
+ case "body-is-null":
1949
+ throw new errors.AthenaIntelligenceError({
1950
+ statusCode: _response.error.statusCode,
1951
+ rawResponse: _response.rawResponse,
1952
+ });
1953
+ case "timeout":
1954
+ throw new errors.AthenaIntelligenceTimeoutError("Timeout exceeded when calling POST /api/v0/assets/{asset_id}/studio-token.");
1955
+ case "unknown":
1956
+ throw new errors.AthenaIntelligenceError({
1957
+ message: _response.error.errorMessage,
1958
+ rawResponse: _response.rawResponse,
1959
+ });
1960
+ }
1961
+ });
1962
+ }
1870
1963
  /**
1871
1964
  * Update the workspace-level access on an asset. Needs edit access to the asset. Set 'view' or 'edit' to grant workspace-wide access, which also needs permission to share with the workspace. Set 'none' (or null) to remove the workspace-wide share, as DELETE does; removing a folder's share also removes it from the assets inside the folder. People and groups the asset is shared with directly keep their access.
1872
1965
  *
@@ -0,0 +1,15 @@
1
+ import type * as AthenaIntelligence from "../../../../index.js";
2
+ /**
3
+ * @example
4
+ * {
5
+ * asset_id: "asset_92492920-d118-42d3-95b4-00eccfe0754f",
6
+ * body: {
7
+ * access: "edit"
8
+ * }
9
+ * }
10
+ */
11
+ export interface CreateStudioTokenAssetsRequest {
12
+ /** The spreadsheet, Word document or deck to mint a token for */
13
+ asset_id: string;
14
+ body: AthenaIntelligence.StudioTokenRequestIn | null;
15
+ }
@@ -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 });
@@ -5,6 +5,7 @@ export type { ConvertExcelToSheetRequestIn } from "./ConvertExcelToSheetRequestI
5
5
  export type { ConvertToUserInterfaceAssetsRequest } from "./ConvertToUserInterfaceAssetsRequest.js";
6
6
  export type { CreateAssetRequestIn } from "./CreateAssetRequestIn.js";
7
7
  export type { CreateProjectRequestIn } from "./CreateProjectRequestIn.js";
8
+ export type { CreateStudioTokenAssetsRequest } from "./CreateStudioTokenAssetsRequest.js";
8
9
  export type { DownloadAssetsRequest } from "./DownloadAssetsRequest.js";
9
10
  export type { DuplicateAssetRequestIn } from "./DuplicateAssetRequestIn.js";
10
11
  export type { GetAccessAssetsRequest } from "./GetAccessAssetsRequest.js";
@@ -39,6 +39,30 @@ export declare class EmailClient {
39
39
  */
40
40
  createDraft(request: AthenaIntelligence.tools.EmailDraftRequestIn, requestOptions?: EmailClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.EmailDraftResponseOut>;
41
41
  private __createDraft;
42
+ /**
43
+ * Read one message from the caller's connected Gmail or Outlook mailbox.
44
+ *
45
+ * Returns its headers and its body as plain text, so an agent can keep the
46
+ * whole email (in a CRM timeline, for example) rather than the search
47
+ * snippet. Read-only; attachments are not returned.
48
+ *
49
+ * @param {AthenaIntelligence.tools.GetMessageEmailRequest} request
50
+ * @param {EmailClient.RequestOptions} requestOptions - Request-specific configuration.
51
+ *
52
+ * @throws {@link AthenaIntelligence.BadRequestError}
53
+ * @throws {@link AthenaIntelligence.ForbiddenError}
54
+ * @throws {@link AthenaIntelligence.NotFoundError}
55
+ * @throws {@link AthenaIntelligence.UnprocessableEntityError}
56
+ * @throws {@link AthenaIntelligence.TooManyRequestsError}
57
+ * @throws {@link AthenaIntelligence.BadGatewayError}
58
+ *
59
+ * @example
60
+ * await client.tools.email.getMessage({
61
+ * message_id: "18f2a7c3b9d4e5f6"
62
+ * })
63
+ */
64
+ getMessage(request: AthenaIntelligence.tools.GetMessageEmailRequest, requestOptions?: EmailClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.EmailMessageResponseOut>;
65
+ private __getMessage;
42
66
  /**
43
67
  * Search the caller's connected Gmail or Outlook mailbox.
44
68
  *
@@ -154,6 +154,104 @@ class EmailClient {
154
154
  }
155
155
  });
156
156
  }
157
+ /**
158
+ * Read one message from the caller's connected Gmail or Outlook mailbox.
159
+ *
160
+ * Returns its headers and its body as plain text, so an agent can keep the
161
+ * whole email (in a CRM timeline, for example) rather than the search
162
+ * snippet. Read-only; attachments are not returned.
163
+ *
164
+ * @param {AthenaIntelligence.tools.GetMessageEmailRequest} request
165
+ * @param {EmailClient.RequestOptions} requestOptions - Request-specific configuration.
166
+ *
167
+ * @throws {@link AthenaIntelligence.BadRequestError}
168
+ * @throws {@link AthenaIntelligence.ForbiddenError}
169
+ * @throws {@link AthenaIntelligence.NotFoundError}
170
+ * @throws {@link AthenaIntelligence.UnprocessableEntityError}
171
+ * @throws {@link AthenaIntelligence.TooManyRequestsError}
172
+ * @throws {@link AthenaIntelligence.BadGatewayError}
173
+ *
174
+ * @example
175
+ * await client.tools.email.getMessage({
176
+ * message_id: "18f2a7c3b9d4e5f6"
177
+ * })
178
+ */
179
+ getMessage(request, requestOptions) {
180
+ return core.HttpResponsePromise.fromPromise(this.__getMessage(request, requestOptions));
181
+ }
182
+ __getMessage(request, requestOptions) {
183
+ return __awaiter(this, void 0, void 0, function* () {
184
+ var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
185
+ const { message_id: messageId, catalog_id: catalogId } = request;
186
+ const _queryParams = {};
187
+ if (catalogId !== undefined) {
188
+ _queryParams.catalog_id = catalogId;
189
+ }
190
+ const _authRequest = yield this._options.authProvider.getAuthRequest();
191
+ 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)({
192
+ "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,
193
+ }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
194
+ const _response = yield ((_d = this._options.fetcher) !== null && _d !== void 0 ? _d : core.fetcher)({
195
+ url: core.url.join((_f = (_e = (yield core.Supplier.get(this._options.baseUrl))) !== null && _e !== void 0 ? _e : (yield core.Supplier.get(this._options.environment))) !== null && _f !== void 0 ? _f : environments.AthenaIntelligenceEnvironment.Production, `api/v0/tools/email/messages/${core.url.encodePathParam(messageId)}`),
196
+ method: "GET",
197
+ headers: _headers,
198
+ queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
199
+ 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,
200
+ 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,
201
+ abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
202
+ fetchFn: (_m = this._options) === null || _m === void 0 ? void 0 : _m.fetch,
203
+ logging: this._options.logging,
204
+ });
205
+ if (_response.ok) {
206
+ return {
207
+ data: _response.body,
208
+ rawResponse: _response.rawResponse,
209
+ };
210
+ }
211
+ if (_response.error.reason === "status-code") {
212
+ switch (_response.error.statusCode) {
213
+ case 400:
214
+ throw new AthenaIntelligence.BadRequestError(_response.error.body, _response.rawResponse);
215
+ case 403:
216
+ throw new AthenaIntelligence.ForbiddenError(_response.error.body, _response.rawResponse);
217
+ case 404:
218
+ throw new AthenaIntelligence.NotFoundError(_response.error.body, _response.rawResponse);
219
+ case 422:
220
+ throw new AthenaIntelligence.UnprocessableEntityError(_response.error.body, _response.rawResponse);
221
+ case 429:
222
+ throw new AthenaIntelligence.TooManyRequestsError(_response.error.body, _response.rawResponse);
223
+ case 502:
224
+ throw new AthenaIntelligence.BadGatewayError(_response.error.body, _response.rawResponse);
225
+ default:
226
+ throw new errors.AthenaIntelligenceError({
227
+ statusCode: _response.error.statusCode,
228
+ body: _response.error.body,
229
+ rawResponse: _response.rawResponse,
230
+ });
231
+ }
232
+ }
233
+ switch (_response.error.reason) {
234
+ case "non-json":
235
+ throw new errors.AthenaIntelligenceError({
236
+ statusCode: _response.error.statusCode,
237
+ body: _response.error.rawBody,
238
+ rawResponse: _response.rawResponse,
239
+ });
240
+ case "body-is-null":
241
+ throw new errors.AthenaIntelligenceError({
242
+ statusCode: _response.error.statusCode,
243
+ rawResponse: _response.rawResponse,
244
+ });
245
+ case "timeout":
246
+ throw new errors.AthenaIntelligenceTimeoutError("Timeout exceeded when calling GET /api/v0/tools/email/messages/{message_id}.");
247
+ case "unknown":
248
+ throw new errors.AthenaIntelligenceError({
249
+ message: _response.error.errorMessage,
250
+ rawResponse: _response.rawResponse,
251
+ });
252
+ }
253
+ });
254
+ }
157
255
  /**
158
256
  * Search the caller's connected Gmail or Outlook mailbox.
159
257
  *
@@ -0,0 +1,12 @@
1
+ /**
2
+ * @example
3
+ * {
4
+ * message_id: "18f2a7c3b9d4e5f6"
5
+ * }
6
+ */
7
+ export interface GetMessageEmailRequest {
8
+ /** Provider message id, as `GET /tools/email/search` returns it in `results[].id`. */
9
+ message_id: string;
10
+ /** Connected email account to use, as the catalog asset id returned by the Athena UI or the assets API. Defaults to the caller's default email account. An id that is not one of the caller's own connected accounts in the current workspace is a 404. */
11
+ catalog_id?: string | null;
12
+ }
@@ -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 });
@@ -1,2 +1,3 @@
1
1
  export type { EmailDraftRequestIn } from "./EmailDraftRequestIn.js";
2
+ export type { GetMessageEmailRequest } from "./GetMessageEmailRequest.js";
2
3
  export type { SearchEmailRequest } from "./SearchEmailRequest.js";
@@ -0,0 +1,33 @@
1
+ /**
2
+ * One message's headers and plain-text body.
3
+ */
4
+ export interface EmailMessageResponseOut {
5
+ /** The message body as plain text, HTML converted. At most 50,000 characters; see `truncated`. */
6
+ body_text?: string;
7
+ /** The connected account the message was read from. */
8
+ catalog_id: string;
9
+ /** Cc recipients, comma-separated as the provider reports them. */
10
+ cc?: string;
11
+ /** Microsoft Graph conversation id. Outlook accounts only. */
12
+ conversation_id?: string | null;
13
+ /** Sent or received timestamp, in the provider's format. */
14
+ date?: string;
15
+ /** Provider draft id, when the provider exposes one for a draft. */
16
+ draft_id?: string | null;
17
+ /** Sender, as the provider reports it. */
18
+ from?: string;
19
+ /** Provider message id, as `GET /tools/email/search` returns it and `reply_to_message_id` accepts. */
20
+ id: string;
21
+ /** True when the message is an unsent draft sitting in the mailbox. */
22
+ is_draft?: boolean;
23
+ /** Account provider as Athena reports it: `gmail` or `outlook` for accounts connected through the Integrations page; `google` or `microsoft365` for directly-connected accounts. */
24
+ provider: string;
25
+ /** Subject line. */
26
+ subject?: string;
27
+ /** Gmail thread id. Gmail accounts only. */
28
+ thread_id?: string | null;
29
+ /** Recipients, comma-separated as the provider reports them. */
30
+ to?: string;
31
+ /** True when `body_text` was cut to its maximum length. */
32
+ truncated?: boolean;
33
+ }
@@ -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 });
@@ -0,0 +1,15 @@
1
+ /**
2
+ * The access a studio token is asked for: a ceiling, not a grant.
3
+ */
4
+ export interface StudioTokenRequestIn {
5
+ /** 'edit' asks for a read-write token and gets one only when the caller can edit the asset (and it is not archived); 'view' always gets a read-only token. Omitted, the token carries the caller's own access. */
6
+ access?: StudioTokenRequestIn.Access;
7
+ }
8
+ export declare namespace StudioTokenRequestIn {
9
+ /** 'edit' asks for a read-write token and gets one only when the caller can edit the asset (and it is not archived); 'view' always gets a read-only token. Omitted, the token carries the caller's own access. */
10
+ const Access: {
11
+ readonly View: "view";
12
+ readonly Edit: "edit";
13
+ };
14
+ type Access = (typeof Access)[keyof typeof Access];
15
+ }
@@ -0,0 +1,12 @@
1
+ "use strict";
2
+ // This file was auto-generated by Fern from our API Definition.
3
+ Object.defineProperty(exports, "__esModule", { value: true });
4
+ exports.StudioTokenRequestIn = void 0;
5
+ var StudioTokenRequestIn;
6
+ (function (StudioTokenRequestIn) {
7
+ /** 'edit' asks for a read-write token and gets one only when the caller can edit the asset (and it is not archived); 'view' always gets a read-only token. Omitted, the token carries the caller's own access. */
8
+ StudioTokenRequestIn.Access = {
9
+ View: "view",
10
+ Edit: "edit",
11
+ };
12
+ })(StudioTokenRequestIn || (exports.StudioTokenRequestIn = StudioTokenRequestIn = {}));
@@ -0,0 +1,32 @@
1
+ /**
2
+ * An asset token for the service that edits the asset.
3
+ */
4
+ export interface StudioTokenResponseOut {
5
+ /** The access the token carries: r reads only (the service refuses its writes), rw reads and writes. The service still checks the caller's live permission on every request. */
6
+ access_type: StudioTokenResponseOut.AccessType;
7
+ /** The asset the token is for. */
8
+ asset_id: string;
9
+ /** The editing service the token is for, as the token's audience identifier: one for spreadsheets, one for Word documents, one for decks. Compare it with the service you call before sending the token. */
10
+ audience: StudioTokenResponseOut.Audience;
11
+ /** For a deck, the id the deck's editing service names it by in its routes (an older deck's own deck id, else its asset id); the token is good for that id. Null for any other asset. */
12
+ deck_id?: string | null;
13
+ /** Expiry in epoch milliseconds, at most 15 minutes from now. Mint a new token before it passes. */
14
+ expires_at_ms: number;
15
+ /** The asset token (``aat_…``). Send it as ``Authorization: Bearer <token>`` to the editing service ``audience`` names, on its routes for this asset only: it names one user, this asset, one access level and that service, and every other route and service refuses it. */
16
+ token: string;
17
+ }
18
+ export declare namespace StudioTokenResponseOut {
19
+ /** The access the token carries: r reads only (the service refuses its writes), rw reads and writes. The service still checks the caller's live permission on every request. */
20
+ const AccessType: {
21
+ readonly R: "r";
22
+ readonly Rw: "rw";
23
+ };
24
+ type AccessType = (typeof AccessType)[keyof typeof AccessType];
25
+ /** The editing service the token is for, as the token's audience identifier: one for spreadsheets, one for Word documents, one for decks. Compare it with the service you call before sending the token. */
26
+ const Audience: {
27
+ readonly DocxStudio: "docx-studio";
28
+ readonly PptxStudio: "pptx-studio";
29
+ readonly XlsxStudio: "xlsx-studio";
30
+ };
31
+ type Audience = (typeof Audience)[keyof typeof Audience];
32
+ }
@@ -0,0 +1,18 @@
1
+ "use strict";
2
+ // This file was auto-generated by Fern from our API Definition.
3
+ Object.defineProperty(exports, "__esModule", { value: true });
4
+ exports.StudioTokenResponseOut = void 0;
5
+ var StudioTokenResponseOut;
6
+ (function (StudioTokenResponseOut) {
7
+ /** The access the token carries: r reads only (the service refuses its writes), rw reads and writes. The service still checks the caller's live permission on every request. */
8
+ StudioTokenResponseOut.AccessType = {
9
+ R: "r",
10
+ Rw: "rw",
11
+ };
12
+ /** The editing service the token is for, as the token's audience identifier: one for spreadsheets, one for Word documents, one for decks. Compare it with the service you call before sending the token. */
13
+ StudioTokenResponseOut.Audience = {
14
+ DocxStudio: "docx-studio",
15
+ PptxStudio: "pptx-studio",
16
+ XlsxStudio: "xlsx-studio",
17
+ };
18
+ })(StudioTokenResponseOut || (exports.StudioTokenResponseOut = StudioTokenResponseOut = {}));
@@ -72,6 +72,7 @@ export * from "./DeployComputerResponseOut.js";
72
72
  export * from "./DimensionProperties.js";
73
73
  export * from "./DuplicateAssetResponseOut.js";
74
74
  export * from "./EmailDraftResponseOut.js";
75
+ export * from "./EmailMessageResponseOut.js";
75
76
  export * from "./EmailSearchResponseOut.js";
76
77
  export * from "./EmailSearchResultOut.js";
77
78
  export * from "./FileTooLargeError.js";
@@ -145,6 +146,8 @@ export * from "./SshAccessTokenOut.js";
145
146
  export * from "./SshKeyListResponseOut.js";
146
147
  export * from "./SshKeyOut.js";
147
148
  export * from "./StructuredDataExtractorResponse.js";
149
+ export * from "./StudioTokenRequestIn.js";
150
+ export * from "./StudioTokenResponseOut.js";
148
151
  export * from "./TableRowData.js";
149
152
  export * from "./TextContent.js";
150
153
  export * from "./TextFormatModel.js";
@@ -88,6 +88,7 @@ __exportStar(require("./DeployComputerResponseOut.js"), exports);
88
88
  __exportStar(require("./DimensionProperties.js"), exports);
89
89
  __exportStar(require("./DuplicateAssetResponseOut.js"), exports);
90
90
  __exportStar(require("./EmailDraftResponseOut.js"), exports);
91
+ __exportStar(require("./EmailMessageResponseOut.js"), exports);
91
92
  __exportStar(require("./EmailSearchResponseOut.js"), exports);
92
93
  __exportStar(require("./EmailSearchResultOut.js"), exports);
93
94
  __exportStar(require("./FileTooLargeError.js"), exports);
@@ -161,6 +162,8 @@ __exportStar(require("./SshAccessTokenOut.js"), exports);
161
162
  __exportStar(require("./SshKeyListResponseOut.js"), exports);
162
163
  __exportStar(require("./SshKeyOut.js"), exports);
163
164
  __exportStar(require("./StructuredDataExtractorResponse.js"), exports);
165
+ __exportStar(require("./StudioTokenRequestIn.js"), exports);
166
+ __exportStar(require("./StudioTokenResponseOut.js"), exports);
164
167
  __exportStar(require("./TableRowData.js"), exports);
165
168
  __exportStar(require("./TextContent.js"), exports);
166
169
  __exportStar(require("./TextFormatModel.js"), exports);
@@ -1 +1 @@
1
- export declare const SDK_VERSION = "4.3.2267";
1
+ export declare const SDK_VERSION = "4.3.2269";
@@ -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.2267";
4
+ exports.SDK_VERSION = "4.3.2269";
@@ -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.2267",
10
- "User-Agent": "@athenaintel/sdk/4.3.2267",
9
+ "X-Fern-SDK-Version": "4.3.2269",
10
+ "User-Agent": "@athenaintel/sdk/4.3.2269",
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,
@@ -413,6 +413,28 @@ export declare class AssetsClient {
413
413
  */
414
414
  updateSkillConfig(request: AthenaIntelligence.UpdateSkillConfigRequestIn, requestOptions?: AssetsClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.UpdateAssetConfigResponseOut>;
415
415
  private __updateSkillConfig;
416
+ /**
417
+ * Mint a short-lived asset token for the service that edits an asset: a spreadsheet's, a Word document's or a deck's, named in ``audience``. The token names the caller, this asset and one access level, lasts 15 minutes and is good only on that service's routes for this asset, so code (an SDK in a computer, for example) never sends the service a long-lived credential. The caller must be able to view the asset and be a member of its workspace; the token is read-write only when the caller can edit the asset and asked for edit. A computer's or session's credential mints tokens for assets of its own workspace only. Any other asset (another type, a live provider file, or one outside every workspace) is refused with 422.
418
+ *
419
+ * @param {AthenaIntelligence.CreateStudioTokenAssetsRequest} request
420
+ * @param {AssetsClient.RequestOptions} requestOptions - Request-specific configuration.
421
+ *
422
+ * @throws {@link AthenaIntelligence.BadRequestError}
423
+ * @throws {@link AthenaIntelligence.ForbiddenError}
424
+ * @throws {@link AthenaIntelligence.NotFoundError}
425
+ * @throws {@link AthenaIntelligence.UnprocessableEntityError}
426
+ * @throws {@link AthenaIntelligence.ServiceUnavailableError}
427
+ *
428
+ * @example
429
+ * await client.assets.createStudioToken({
430
+ * asset_id: "asset_92492920-d118-42d3-95b4-00eccfe0754f",
431
+ * body: {
432
+ * access: "edit"
433
+ * }
434
+ * })
435
+ */
436
+ createStudioToken(request: AthenaIntelligence.CreateStudioTokenAssetsRequest, requestOptions?: AssetsClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.StudioTokenResponseOut>;
437
+ private __createStudioToken;
416
438
  /**
417
439
  * Update the workspace-level access on an asset. Needs edit access to the asset. Set 'view' or 'edit' to grant workspace-wide access, which also needs permission to share with the workspace. Set 'none' (or null) to remove the workspace-wide share, as DELETE does; removing a folder's share also removes it from the assets inside the folder. People and groups the asset is shared with directly keep their access.
418
440
  *
@@ -1831,6 +1831,99 @@ export class AssetsClient {
1831
1831
  }
1832
1832
  });
1833
1833
  }
1834
+ /**
1835
+ * Mint a short-lived asset token for the service that edits an asset: a spreadsheet's, a Word document's or a deck's, named in ``audience``. The token names the caller, this asset and one access level, lasts 15 minutes and is good only on that service's routes for this asset, so code (an SDK in a computer, for example) never sends the service a long-lived credential. The caller must be able to view the asset and be a member of its workspace; the token is read-write only when the caller can edit the asset and asked for edit. A computer's or session's credential mints tokens for assets of its own workspace only. Any other asset (another type, a live provider file, or one outside every workspace) is refused with 422.
1836
+ *
1837
+ * @param {AthenaIntelligence.CreateStudioTokenAssetsRequest} request
1838
+ * @param {AssetsClient.RequestOptions} requestOptions - Request-specific configuration.
1839
+ *
1840
+ * @throws {@link AthenaIntelligence.BadRequestError}
1841
+ * @throws {@link AthenaIntelligence.ForbiddenError}
1842
+ * @throws {@link AthenaIntelligence.NotFoundError}
1843
+ * @throws {@link AthenaIntelligence.UnprocessableEntityError}
1844
+ * @throws {@link AthenaIntelligence.ServiceUnavailableError}
1845
+ *
1846
+ * @example
1847
+ * await client.assets.createStudioToken({
1848
+ * asset_id: "asset_92492920-d118-42d3-95b4-00eccfe0754f",
1849
+ * body: {
1850
+ * access: "edit"
1851
+ * }
1852
+ * })
1853
+ */
1854
+ createStudioToken(request, requestOptions) {
1855
+ return core.HttpResponsePromise.fromPromise(this.__createStudioToken(request, requestOptions));
1856
+ }
1857
+ __createStudioToken(request, requestOptions) {
1858
+ return __awaiter(this, void 0, void 0, function* () {
1859
+ var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
1860
+ const { asset_id: assetId, body: _body } = request;
1861
+ const _authRequest = yield this._options.authProvider.getAuthRequest();
1862
+ const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({
1863
+ "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,
1864
+ }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
1865
+ const _response = yield ((_d = this._options.fetcher) !== null && _d !== void 0 ? _d : core.fetcher)({
1866
+ 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/${core.url.encodePathParam(assetId)}/studio-token`),
1867
+ method: "POST",
1868
+ headers: _headers,
1869
+ contentType: "application/json",
1870
+ queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
1871
+ requestType: "json",
1872
+ body: _body != null ? _body : undefined,
1873
+ 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,
1874
+ 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,
1875
+ abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
1876
+ fetchFn: (_m = this._options) === null || _m === void 0 ? void 0 : _m.fetch,
1877
+ logging: this._options.logging,
1878
+ });
1879
+ if (_response.ok) {
1880
+ return {
1881
+ data: _response.body,
1882
+ rawResponse: _response.rawResponse,
1883
+ };
1884
+ }
1885
+ if (_response.error.reason === "status-code") {
1886
+ switch (_response.error.statusCode) {
1887
+ case 400:
1888
+ throw new AthenaIntelligence.BadRequestError(_response.error.body, _response.rawResponse);
1889
+ case 403:
1890
+ throw new AthenaIntelligence.ForbiddenError(_response.error.body, _response.rawResponse);
1891
+ case 404:
1892
+ throw new AthenaIntelligence.NotFoundError(_response.error.body, _response.rawResponse);
1893
+ case 422:
1894
+ throw new AthenaIntelligence.UnprocessableEntityError(_response.error.body, _response.rawResponse);
1895
+ case 503:
1896
+ throw new AthenaIntelligence.ServiceUnavailableError(_response.error.body, _response.rawResponse);
1897
+ default:
1898
+ throw new errors.AthenaIntelligenceError({
1899
+ statusCode: _response.error.statusCode,
1900
+ body: _response.error.body,
1901
+ rawResponse: _response.rawResponse,
1902
+ });
1903
+ }
1904
+ }
1905
+ switch (_response.error.reason) {
1906
+ case "non-json":
1907
+ throw new errors.AthenaIntelligenceError({
1908
+ statusCode: _response.error.statusCode,
1909
+ body: _response.error.rawBody,
1910
+ rawResponse: _response.rawResponse,
1911
+ });
1912
+ case "body-is-null":
1913
+ throw new errors.AthenaIntelligenceError({
1914
+ statusCode: _response.error.statusCode,
1915
+ rawResponse: _response.rawResponse,
1916
+ });
1917
+ case "timeout":
1918
+ throw new errors.AthenaIntelligenceTimeoutError("Timeout exceeded when calling POST /api/v0/assets/{asset_id}/studio-token.");
1919
+ case "unknown":
1920
+ throw new errors.AthenaIntelligenceError({
1921
+ message: _response.error.errorMessage,
1922
+ rawResponse: _response.rawResponse,
1923
+ });
1924
+ }
1925
+ });
1926
+ }
1834
1927
  /**
1835
1928
  * Update the workspace-level access on an asset. Needs edit access to the asset. Set 'view' or 'edit' to grant workspace-wide access, which also needs permission to share with the workspace. Set 'none' (or null) to remove the workspace-wide share, as DELETE does; removing a folder's share also removes it from the assets inside the folder. People and groups the asset is shared with directly keep their access.
1836
1929
  *
@@ -0,0 +1,15 @@
1
+ import type * as AthenaIntelligence from "../../../../index.mjs";
2
+ /**
3
+ * @example
4
+ * {
5
+ * asset_id: "asset_92492920-d118-42d3-95b4-00eccfe0754f",
6
+ * body: {
7
+ * access: "edit"
8
+ * }
9
+ * }
10
+ */
11
+ export interface CreateStudioTokenAssetsRequest {
12
+ /** The spreadsheet, Word document or deck to mint a token for */
13
+ asset_id: string;
14
+ body: AthenaIntelligence.StudioTokenRequestIn | null;
15
+ }
@@ -0,0 +1,2 @@
1
+ // This file was auto-generated by Fern from our API Definition.
2
+ export {};
@@ -5,6 +5,7 @@ export type { ConvertExcelToSheetRequestIn } from "./ConvertExcelToSheetRequestI
5
5
  export type { ConvertToUserInterfaceAssetsRequest } from "./ConvertToUserInterfaceAssetsRequest.mjs";
6
6
  export type { CreateAssetRequestIn } from "./CreateAssetRequestIn.mjs";
7
7
  export type { CreateProjectRequestIn } from "./CreateProjectRequestIn.mjs";
8
+ export type { CreateStudioTokenAssetsRequest } from "./CreateStudioTokenAssetsRequest.mjs";
8
9
  export type { DownloadAssetsRequest } from "./DownloadAssetsRequest.mjs";
9
10
  export type { DuplicateAssetRequestIn } from "./DuplicateAssetRequestIn.mjs";
10
11
  export type { GetAccessAssetsRequest } from "./GetAccessAssetsRequest.mjs";
@@ -39,6 +39,30 @@ export declare class EmailClient {
39
39
  */
40
40
  createDraft(request: AthenaIntelligence.tools.EmailDraftRequestIn, requestOptions?: EmailClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.EmailDraftResponseOut>;
41
41
  private __createDraft;
42
+ /**
43
+ * Read one message from the caller's connected Gmail or Outlook mailbox.
44
+ *
45
+ * Returns its headers and its body as plain text, so an agent can keep the
46
+ * whole email (in a CRM timeline, for example) rather than the search
47
+ * snippet. Read-only; attachments are not returned.
48
+ *
49
+ * @param {AthenaIntelligence.tools.GetMessageEmailRequest} request
50
+ * @param {EmailClient.RequestOptions} requestOptions - Request-specific configuration.
51
+ *
52
+ * @throws {@link AthenaIntelligence.BadRequestError}
53
+ * @throws {@link AthenaIntelligence.ForbiddenError}
54
+ * @throws {@link AthenaIntelligence.NotFoundError}
55
+ * @throws {@link AthenaIntelligence.UnprocessableEntityError}
56
+ * @throws {@link AthenaIntelligence.TooManyRequestsError}
57
+ * @throws {@link AthenaIntelligence.BadGatewayError}
58
+ *
59
+ * @example
60
+ * await client.tools.email.getMessage({
61
+ * message_id: "18f2a7c3b9d4e5f6"
62
+ * })
63
+ */
64
+ getMessage(request: AthenaIntelligence.tools.GetMessageEmailRequest, requestOptions?: EmailClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.EmailMessageResponseOut>;
65
+ private __getMessage;
42
66
  /**
43
67
  * Search the caller's connected Gmail or Outlook mailbox.
44
68
  *
@@ -118,6 +118,104 @@ export class EmailClient {
118
118
  }
119
119
  });
120
120
  }
121
+ /**
122
+ * Read one message from the caller's connected Gmail or Outlook mailbox.
123
+ *
124
+ * Returns its headers and its body as plain text, so an agent can keep the
125
+ * whole email (in a CRM timeline, for example) rather than the search
126
+ * snippet. Read-only; attachments are not returned.
127
+ *
128
+ * @param {AthenaIntelligence.tools.GetMessageEmailRequest} request
129
+ * @param {EmailClient.RequestOptions} requestOptions - Request-specific configuration.
130
+ *
131
+ * @throws {@link AthenaIntelligence.BadRequestError}
132
+ * @throws {@link AthenaIntelligence.ForbiddenError}
133
+ * @throws {@link AthenaIntelligence.NotFoundError}
134
+ * @throws {@link AthenaIntelligence.UnprocessableEntityError}
135
+ * @throws {@link AthenaIntelligence.TooManyRequestsError}
136
+ * @throws {@link AthenaIntelligence.BadGatewayError}
137
+ *
138
+ * @example
139
+ * await client.tools.email.getMessage({
140
+ * message_id: "18f2a7c3b9d4e5f6"
141
+ * })
142
+ */
143
+ getMessage(request, requestOptions) {
144
+ return core.HttpResponsePromise.fromPromise(this.__getMessage(request, requestOptions));
145
+ }
146
+ __getMessage(request, requestOptions) {
147
+ return __awaiter(this, void 0, void 0, function* () {
148
+ var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
149
+ const { message_id: messageId, catalog_id: catalogId } = request;
150
+ const _queryParams = {};
151
+ if (catalogId !== undefined) {
152
+ _queryParams.catalog_id = catalogId;
153
+ }
154
+ const _authRequest = yield this._options.authProvider.getAuthRequest();
155
+ const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({
156
+ "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,
157
+ }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
158
+ const _response = yield ((_d = this._options.fetcher) !== null && _d !== void 0 ? _d : core.fetcher)({
159
+ url: core.url.join((_f = (_e = (yield core.Supplier.get(this._options.baseUrl))) !== null && _e !== void 0 ? _e : (yield core.Supplier.get(this._options.environment))) !== null && _f !== void 0 ? _f : environments.AthenaIntelligenceEnvironment.Production, `api/v0/tools/email/messages/${core.url.encodePathParam(messageId)}`),
160
+ method: "GET",
161
+ headers: _headers,
162
+ queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
163
+ 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,
164
+ 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,
165
+ abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
166
+ fetchFn: (_m = this._options) === null || _m === void 0 ? void 0 : _m.fetch,
167
+ logging: this._options.logging,
168
+ });
169
+ if (_response.ok) {
170
+ return {
171
+ data: _response.body,
172
+ rawResponse: _response.rawResponse,
173
+ };
174
+ }
175
+ if (_response.error.reason === "status-code") {
176
+ switch (_response.error.statusCode) {
177
+ case 400:
178
+ throw new AthenaIntelligence.BadRequestError(_response.error.body, _response.rawResponse);
179
+ case 403:
180
+ throw new AthenaIntelligence.ForbiddenError(_response.error.body, _response.rawResponse);
181
+ case 404:
182
+ throw new AthenaIntelligence.NotFoundError(_response.error.body, _response.rawResponse);
183
+ case 422:
184
+ throw new AthenaIntelligence.UnprocessableEntityError(_response.error.body, _response.rawResponse);
185
+ case 429:
186
+ throw new AthenaIntelligence.TooManyRequestsError(_response.error.body, _response.rawResponse);
187
+ case 502:
188
+ throw new AthenaIntelligence.BadGatewayError(_response.error.body, _response.rawResponse);
189
+ default:
190
+ throw new errors.AthenaIntelligenceError({
191
+ statusCode: _response.error.statusCode,
192
+ body: _response.error.body,
193
+ rawResponse: _response.rawResponse,
194
+ });
195
+ }
196
+ }
197
+ switch (_response.error.reason) {
198
+ case "non-json":
199
+ throw new errors.AthenaIntelligenceError({
200
+ statusCode: _response.error.statusCode,
201
+ body: _response.error.rawBody,
202
+ rawResponse: _response.rawResponse,
203
+ });
204
+ case "body-is-null":
205
+ throw new errors.AthenaIntelligenceError({
206
+ statusCode: _response.error.statusCode,
207
+ rawResponse: _response.rawResponse,
208
+ });
209
+ case "timeout":
210
+ throw new errors.AthenaIntelligenceTimeoutError("Timeout exceeded when calling GET /api/v0/tools/email/messages/{message_id}.");
211
+ case "unknown":
212
+ throw new errors.AthenaIntelligenceError({
213
+ message: _response.error.errorMessage,
214
+ rawResponse: _response.rawResponse,
215
+ });
216
+ }
217
+ });
218
+ }
121
219
  /**
122
220
  * Search the caller's connected Gmail or Outlook mailbox.
123
221
  *
@@ -0,0 +1,12 @@
1
+ /**
2
+ * @example
3
+ * {
4
+ * message_id: "18f2a7c3b9d4e5f6"
5
+ * }
6
+ */
7
+ export interface GetMessageEmailRequest {
8
+ /** Provider message id, as `GET /tools/email/search` returns it in `results[].id`. */
9
+ message_id: string;
10
+ /** Connected email account to use, as the catalog asset id returned by the Athena UI or the assets API. Defaults to the caller's default email account. An id that is not one of the caller's own connected accounts in the current workspace is a 404. */
11
+ catalog_id?: string | null;
12
+ }
@@ -0,0 +1,2 @@
1
+ // This file was auto-generated by Fern from our API Definition.
2
+ export {};
@@ -1,2 +1,3 @@
1
1
  export type { EmailDraftRequestIn } from "./EmailDraftRequestIn.mjs";
2
+ export type { GetMessageEmailRequest } from "./GetMessageEmailRequest.mjs";
2
3
  export type { SearchEmailRequest } from "./SearchEmailRequest.mjs";
@@ -0,0 +1,33 @@
1
+ /**
2
+ * One message's headers and plain-text body.
3
+ */
4
+ export interface EmailMessageResponseOut {
5
+ /** The message body as plain text, HTML converted. At most 50,000 characters; see `truncated`. */
6
+ body_text?: string;
7
+ /** The connected account the message was read from. */
8
+ catalog_id: string;
9
+ /** Cc recipients, comma-separated as the provider reports them. */
10
+ cc?: string;
11
+ /** Microsoft Graph conversation id. Outlook accounts only. */
12
+ conversation_id?: string | null;
13
+ /** Sent or received timestamp, in the provider's format. */
14
+ date?: string;
15
+ /** Provider draft id, when the provider exposes one for a draft. */
16
+ draft_id?: string | null;
17
+ /** Sender, as the provider reports it. */
18
+ from?: string;
19
+ /** Provider message id, as `GET /tools/email/search` returns it and `reply_to_message_id` accepts. */
20
+ id: string;
21
+ /** True when the message is an unsent draft sitting in the mailbox. */
22
+ is_draft?: boolean;
23
+ /** Account provider as Athena reports it: `gmail` or `outlook` for accounts connected through the Integrations page; `google` or `microsoft365` for directly-connected accounts. */
24
+ provider: string;
25
+ /** Subject line. */
26
+ subject?: string;
27
+ /** Gmail thread id. Gmail accounts only. */
28
+ thread_id?: string | null;
29
+ /** Recipients, comma-separated as the provider reports them. */
30
+ to?: string;
31
+ /** True when `body_text` was cut to its maximum length. */
32
+ truncated?: boolean;
33
+ }
@@ -0,0 +1,2 @@
1
+ // This file was auto-generated by Fern from our API Definition.
2
+ export {};
@@ -0,0 +1,15 @@
1
+ /**
2
+ * The access a studio token is asked for: a ceiling, not a grant.
3
+ */
4
+ export interface StudioTokenRequestIn {
5
+ /** 'edit' asks for a read-write token and gets one only when the caller can edit the asset (and it is not archived); 'view' always gets a read-only token. Omitted, the token carries the caller's own access. */
6
+ access?: StudioTokenRequestIn.Access;
7
+ }
8
+ export declare namespace StudioTokenRequestIn {
9
+ /** 'edit' asks for a read-write token and gets one only when the caller can edit the asset (and it is not archived); 'view' always gets a read-only token. Omitted, the token carries the caller's own access. */
10
+ const Access: {
11
+ readonly View: "view";
12
+ readonly Edit: "edit";
13
+ };
14
+ type Access = (typeof Access)[keyof typeof Access];
15
+ }
@@ -0,0 +1,9 @@
1
+ // This file was auto-generated by Fern from our API Definition.
2
+ export var StudioTokenRequestIn;
3
+ (function (StudioTokenRequestIn) {
4
+ /** 'edit' asks for a read-write token and gets one only when the caller can edit the asset (and it is not archived); 'view' always gets a read-only token. Omitted, the token carries the caller's own access. */
5
+ StudioTokenRequestIn.Access = {
6
+ View: "view",
7
+ Edit: "edit",
8
+ };
9
+ })(StudioTokenRequestIn || (StudioTokenRequestIn = {}));
@@ -0,0 +1,32 @@
1
+ /**
2
+ * An asset token for the service that edits the asset.
3
+ */
4
+ export interface StudioTokenResponseOut {
5
+ /** The access the token carries: r reads only (the service refuses its writes), rw reads and writes. The service still checks the caller's live permission on every request. */
6
+ access_type: StudioTokenResponseOut.AccessType;
7
+ /** The asset the token is for. */
8
+ asset_id: string;
9
+ /** The editing service the token is for, as the token's audience identifier: one for spreadsheets, one for Word documents, one for decks. Compare it with the service you call before sending the token. */
10
+ audience: StudioTokenResponseOut.Audience;
11
+ /** For a deck, the id the deck's editing service names it by in its routes (an older deck's own deck id, else its asset id); the token is good for that id. Null for any other asset. */
12
+ deck_id?: string | null;
13
+ /** Expiry in epoch milliseconds, at most 15 minutes from now. Mint a new token before it passes. */
14
+ expires_at_ms: number;
15
+ /** The asset token (``aat_…``). Send it as ``Authorization: Bearer <token>`` to the editing service ``audience`` names, on its routes for this asset only: it names one user, this asset, one access level and that service, and every other route and service refuses it. */
16
+ token: string;
17
+ }
18
+ export declare namespace StudioTokenResponseOut {
19
+ /** The access the token carries: r reads only (the service refuses its writes), rw reads and writes. The service still checks the caller's live permission on every request. */
20
+ const AccessType: {
21
+ readonly R: "r";
22
+ readonly Rw: "rw";
23
+ };
24
+ type AccessType = (typeof AccessType)[keyof typeof AccessType];
25
+ /** The editing service the token is for, as the token's audience identifier: one for spreadsheets, one for Word documents, one for decks. Compare it with the service you call before sending the token. */
26
+ const Audience: {
27
+ readonly DocxStudio: "docx-studio";
28
+ readonly PptxStudio: "pptx-studio";
29
+ readonly XlsxStudio: "xlsx-studio";
30
+ };
31
+ type Audience = (typeof Audience)[keyof typeof Audience];
32
+ }
@@ -0,0 +1,15 @@
1
+ // This file was auto-generated by Fern from our API Definition.
2
+ export var StudioTokenResponseOut;
3
+ (function (StudioTokenResponseOut) {
4
+ /** The access the token carries: r reads only (the service refuses its writes), rw reads and writes. The service still checks the caller's live permission on every request. */
5
+ StudioTokenResponseOut.AccessType = {
6
+ R: "r",
7
+ Rw: "rw",
8
+ };
9
+ /** The editing service the token is for, as the token's audience identifier: one for spreadsheets, one for Word documents, one for decks. Compare it with the service you call before sending the token. */
10
+ StudioTokenResponseOut.Audience = {
11
+ DocxStudio: "docx-studio",
12
+ PptxStudio: "pptx-studio",
13
+ XlsxStudio: "xlsx-studio",
14
+ };
15
+ })(StudioTokenResponseOut || (StudioTokenResponseOut = {}));
@@ -72,6 +72,7 @@ export * from "./DeployComputerResponseOut.mjs";
72
72
  export * from "./DimensionProperties.mjs";
73
73
  export * from "./DuplicateAssetResponseOut.mjs";
74
74
  export * from "./EmailDraftResponseOut.mjs";
75
+ export * from "./EmailMessageResponseOut.mjs";
75
76
  export * from "./EmailSearchResponseOut.mjs";
76
77
  export * from "./EmailSearchResultOut.mjs";
77
78
  export * from "./FileTooLargeError.mjs";
@@ -145,6 +146,8 @@ export * from "./SshAccessTokenOut.mjs";
145
146
  export * from "./SshKeyListResponseOut.mjs";
146
147
  export * from "./SshKeyOut.mjs";
147
148
  export * from "./StructuredDataExtractorResponse.mjs";
149
+ export * from "./StudioTokenRequestIn.mjs";
150
+ export * from "./StudioTokenResponseOut.mjs";
148
151
  export * from "./TableRowData.mjs";
149
152
  export * from "./TextContent.mjs";
150
153
  export * from "./TextFormatModel.mjs";
@@ -72,6 +72,7 @@ export * from "./DeployComputerResponseOut.mjs";
72
72
  export * from "./DimensionProperties.mjs";
73
73
  export * from "./DuplicateAssetResponseOut.mjs";
74
74
  export * from "./EmailDraftResponseOut.mjs";
75
+ export * from "./EmailMessageResponseOut.mjs";
75
76
  export * from "./EmailSearchResponseOut.mjs";
76
77
  export * from "./EmailSearchResultOut.mjs";
77
78
  export * from "./FileTooLargeError.mjs";
@@ -145,6 +146,8 @@ export * from "./SshAccessTokenOut.mjs";
145
146
  export * from "./SshKeyListResponseOut.mjs";
146
147
  export * from "./SshKeyOut.mjs";
147
148
  export * from "./StructuredDataExtractorResponse.mjs";
149
+ export * from "./StudioTokenRequestIn.mjs";
150
+ export * from "./StudioTokenResponseOut.mjs";
148
151
  export * from "./TableRowData.mjs";
149
152
  export * from "./TextContent.mjs";
150
153
  export * from "./TextFormatModel.mjs";
@@ -1 +1 @@
1
- export declare const SDK_VERSION = "4.3.2267";
1
+ export declare const SDK_VERSION = "4.3.2269";
@@ -1 +1 @@
1
- export const SDK_VERSION = "4.3.2267";
1
+ export const SDK_VERSION = "4.3.2269";
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@athenaintel/sdk",
3
- "version": "4.3.2267",
3
+ "version": "4.3.2269",
4
4
  "private": false,
5
5
  "repository": "github:Athena-Intel/athena-typescript",
6
6
  "type": "commonjs",
package/reference.md CHANGED
@@ -1842,6 +1842,74 @@ await client.assets.updateSkillConfig({
1842
1842
  </dl>
1843
1843
 
1844
1844
 
1845
+ </dd>
1846
+ </dl>
1847
+ </details>
1848
+
1849
+ <details><summary><code>client.assets.<a href="/src/api/resources/assets/client/Client.ts">createStudioToken</a>({ ...params }) -> AthenaIntelligence.StudioTokenResponseOut</code></summary>
1850
+ <dl>
1851
+ <dd>
1852
+
1853
+ #### 📝 Description
1854
+
1855
+ <dl>
1856
+ <dd>
1857
+
1858
+ <dl>
1859
+ <dd>
1860
+
1861
+ Mint a short-lived asset token for the service that edits an asset: a spreadsheet's, a Word document's or a deck's, named in ``audience``. The token names the caller, this asset and one access level, lasts 15 minutes and is good only on that service's routes for this asset, so code (an SDK in a computer, for example) never sends the service a long-lived credential. The caller must be able to view the asset and be a member of its workspace; the token is read-write only when the caller can edit the asset and asked for edit. A computer's or session's credential mints tokens for assets of its own workspace only. Any other asset (another type, a live provider file, or one outside every workspace) is refused with 422.
1862
+ </dd>
1863
+ </dl>
1864
+ </dd>
1865
+ </dl>
1866
+
1867
+ #### 🔌 Usage
1868
+
1869
+ <dl>
1870
+ <dd>
1871
+
1872
+ <dl>
1873
+ <dd>
1874
+
1875
+ ```typescript
1876
+ await client.assets.createStudioToken({
1877
+ asset_id: "asset_92492920-d118-42d3-95b4-00eccfe0754f",
1878
+ body: {
1879
+ access: "edit"
1880
+ }
1881
+ });
1882
+
1883
+ ```
1884
+ </dd>
1885
+ </dl>
1886
+ </dd>
1887
+ </dl>
1888
+
1889
+ #### ⚙️ Parameters
1890
+
1891
+ <dl>
1892
+ <dd>
1893
+
1894
+ <dl>
1895
+ <dd>
1896
+
1897
+ **request:** `AthenaIntelligence.CreateStudioTokenAssetsRequest`
1898
+
1899
+ </dd>
1900
+ </dl>
1901
+
1902
+ <dl>
1903
+ <dd>
1904
+
1905
+ **requestOptions:** `AssetsClient.RequestOptions`
1906
+
1907
+ </dd>
1908
+ </dl>
1909
+ </dd>
1910
+ </dl>
1911
+
1912
+
1845
1913
  </dd>
1846
1914
  </dl>
1847
1915
  </details>
@@ -6605,6 +6673,75 @@ await client.tools.email.createDraft({
6605
6673
  </dl>
6606
6674
 
6607
6675
 
6676
+ </dd>
6677
+ </dl>
6678
+ </details>
6679
+
6680
+ <details><summary><code>client.tools.email.<a href="/src/api/resources/tools/resources/email/client/Client.ts">getMessage</a>({ ...params }) -> AthenaIntelligence.EmailMessageResponseOut</code></summary>
6681
+ <dl>
6682
+ <dd>
6683
+
6684
+ #### 📝 Description
6685
+
6686
+ <dl>
6687
+ <dd>
6688
+
6689
+ <dl>
6690
+ <dd>
6691
+
6692
+ Read one message from the caller's connected Gmail or Outlook mailbox.
6693
+
6694
+ Returns its headers and its body as plain text, so an agent can keep the
6695
+ whole email (in a CRM timeline, for example) rather than the search
6696
+ snippet. Read-only; attachments are not returned.
6697
+ </dd>
6698
+ </dl>
6699
+ </dd>
6700
+ </dl>
6701
+
6702
+ #### 🔌 Usage
6703
+
6704
+ <dl>
6705
+ <dd>
6706
+
6707
+ <dl>
6708
+ <dd>
6709
+
6710
+ ```typescript
6711
+ await client.tools.email.getMessage({
6712
+ message_id: "18f2a7c3b9d4e5f6"
6713
+ });
6714
+
6715
+ ```
6716
+ </dd>
6717
+ </dl>
6718
+ </dd>
6719
+ </dl>
6720
+
6721
+ #### ⚙️ Parameters
6722
+
6723
+ <dl>
6724
+ <dd>
6725
+
6726
+ <dl>
6727
+ <dd>
6728
+
6729
+ **request:** `AthenaIntelligence.tools.GetMessageEmailRequest`
6730
+
6731
+ </dd>
6732
+ </dl>
6733
+
6734
+ <dl>
6735
+ <dd>
6736
+
6737
+ **requestOptions:** `EmailClient.RequestOptions`
6738
+
6739
+ </dd>
6740
+ </dl>
6741
+ </dd>
6742
+ </dl>
6743
+
6744
+
6608
6745
  </dd>
6609
6746
  </dl>
6610
6747
  </details>