@athenaintel/sdk 4.3.2214 → 4.3.2216

package/dist/cjs/BaseClient.js

@@ -43,8 +43,8 @@ function normalizeClientOptions(options) {
     const headers = (0, headers_js_1.mergeHeaders)({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "@athenaintel/sdk",
-        "X-Fern-SDK-Version": "4.3.2214",
-        "User-Agent": "@athenaintel/sdk/4.3.2214",
+        "X-Fern-SDK-Version": "4.3.2216",
+        "User-Agent": "@athenaintel/sdk/4.3.2216",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
         "X-Athena-Session-Credential": options === null || options === void 0 ? void 0 : options.sessionCredential,

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

@@ -21,6 +21,16 @@ export declare class UsersClient {
      */
     me(requestOptions?: UsersClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.UserInfoOut>;
     private __me;
+    /**
+     * The caller's email preferences for agent-sent mail in their current workspace: the domains and specific addresses they have approved as recipients, plus their custom drafting instruction. Built for computer-asset apps that compose or send email on the user's behalf, so they apply the same recipient policy the chat email tools enforce — a recipient is approved when its full address is in `approved_emails` or its domain is in `approved_domains` (both compared case-insensitively). Read-only: the policy is edited from Settings → Email & Meetings (`manage_url`).
+     *
+     * @param {UsersClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.users.meEmailPreferences()
+     */
+    meEmailPreferences(requestOptions?: UsersClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.MeEmailPreferencesResponseOut>;
+    private __meEmailPreferences;
     /**
      * Counts of the caller's connected Microsoft 365 sources (mail, files, sites, chats) plus live SharePoint provisioning progress. Built for computer-asset apps to render a 'setting up your sources' state right after a viewer's first sign-in, while the background fan-outs are still filling in SharePoint and Teams.
      *

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

@@ -115,6 +115,70 @@ class UsersClient {
             }
         });
     }
+    /**
+     * The caller's email preferences for agent-sent mail in their current workspace: the domains and specific addresses they have approved as recipients, plus their custom drafting instruction. Built for computer-asset apps that compose or send email on the user's behalf, so they apply the same recipient policy the chat email tools enforce — a recipient is approved when its full address is in `approved_emails` or its domain is in `approved_domains` (both compared case-insensitively). Read-only: the policy is edited from Settings → Email & Meetings (`manage_url`).
+     *
+     * @param {UsersClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.users.meEmailPreferences()
+     */
+    meEmailPreferences(requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__meEmailPreferences(requestOptions));
+    }
+    __meEmailPreferences(requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({
+                "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,
+            }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield ((_d = this._options.fetcher) !== null && _d !== void 0 ? _d : core.fetcher)({
+                url: core.url.join((_f = (_e = (yield core.Supplier.get(this._options.baseUrl))) !== null && _e !== void 0 ? _e : (yield core.Supplier.get(this._options.environment))) !== null && _f !== void 0 ? _f : environments.AthenaIntelligenceEnvironment.Production, "api/v0/me/email-preferences"),
+                method: "GET",
+                headers: _headers,
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                timeoutMs: ((_j = (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.timeoutInSeconds) !== null && _j !== void 0 ? _j : 60) * 1000,
+                maxRetries: (_k = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _k !== void 0 ? _k : (_l = this._options) === null || _l === void 0 ? void 0 : _l.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_m = this._options) === null || _m === void 0 ? void 0 : _m.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: _response.body,
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                throw new errors.AthenaIntelligenceError({
+                    statusCode: _response.error.statusCode,
+                    body: _response.error.body,
+                    rawResponse: _response.rawResponse,
+                });
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.AthenaIntelligenceError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "body-is-null":
+                    throw new errors.AthenaIntelligenceError({
+                        statusCode: _response.error.statusCode,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.AthenaIntelligenceTimeoutError("Timeout exceeded when calling GET /api/v0/me/email-preferences.");
+                case "unknown":
+                    throw new errors.AthenaIntelligenceError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
     /**
      * Counts of the caller's connected Microsoft 365 sources (mail, files, sites, chats) plus live SharePoint provisioning progress. Built for computer-asset apps to render a 'setting up your sources' state right after a viewer's first sign-in, while the background fan-outs are still filling in SharePoint and Teams.
      *

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

@@ -0,0 +1,13 @@
+/**
+ * The caller's approved-recipient policy for agent-sent email.
+ */
+export interface MeEmailPreferencesResponseOut {
+    /** Domains the agent may email anyone at, as bare lowercase domains (`acme.com`). Match a recipient's domain against this list. */
+    approved_domains: string[];
+    /** Specific addresses the agent may email, lowercase (`user@acme.com`). Match the whole recipient address against this list. */
+    approved_emails: string[];
+    /** Free-text guidance the user wants followed whenever an agent drafts email on their behalf; null when none is set. */
+    custom_instruction?: string | null;
+    /** Where the user edits this policy (Settings → Email & Meetings). Send the user here when a recipient is not approved; the policy cannot be changed through this API. */
+    manage_url: string;
+}

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

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -83,6 +83,7 @@ export * from "./InitializationRecipeStage.js";
 export * from "./InitializationState.js";
 export * from "./InputMessage.js";
 export * from "./InputMessageContentOneItem.js";
+export * from "./MeEmailPreferencesResponseOut.js";
 export * from "./MeetingArtifactsOut.js";
 export * from "./MeetingOut.js";
 export * from "./MeetingParticipantOut.js";

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

@@ -99,6 +99,7 @@ __exportStar(require("./InitializationRecipeStage.js"), exports);
 __exportStar(require("./InitializationState.js"), exports);
 __exportStar(require("./InputMessage.js"), exports);
 __exportStar(require("./InputMessageContentOneItem.js"), exports);
+__exportStar(require("./MeEmailPreferencesResponseOut.js"), exports);
 __exportStar(require("./MeetingArtifactsOut.js"), exports);
 __exportStar(require("./MeetingOut.js"), exports);
 __exportStar(require("./MeetingParticipantOut.js"), exports);

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "4.3.2214";
+export declare const SDK_VERSION = "4.3.2216";

package/dist/cjs/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = "4.3.2214";
+exports.SDK_VERSION = "4.3.2216";

package/dist/esm/BaseClient.mjs

@@ -6,8 +6,8 @@ export function normalizeClientOptions(options) {
     const headers = mergeHeaders({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "@athenaintel/sdk",
-        "X-Fern-SDK-Version": "4.3.2214",
-        "User-Agent": "@athenaintel/sdk/4.3.2214",
+        "X-Fern-SDK-Version": "4.3.2216",
+        "User-Agent": "@athenaintel/sdk/4.3.2216",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
         "X-Athena-Session-Credential": options === null || options === void 0 ? void 0 : options.sessionCredential,

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

@@ -21,6 +21,16 @@ export declare class UsersClient {
      */
     me(requestOptions?: UsersClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.UserInfoOut>;
     private __me;
+    /**
+     * The caller's email preferences for agent-sent mail in their current workspace: the domains and specific addresses they have approved as recipients, plus their custom drafting instruction. Built for computer-asset apps that compose or send email on the user's behalf, so they apply the same recipient policy the chat email tools enforce — a recipient is approved when its full address is in `approved_emails` or its domain is in `approved_domains` (both compared case-insensitively). Read-only: the policy is edited from Settings → Email & Meetings (`manage_url`).
+     *
+     * @param {UsersClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.users.meEmailPreferences()
+     */
+    meEmailPreferences(requestOptions?: UsersClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.MeEmailPreferencesResponseOut>;
+    private __meEmailPreferences;
     /**
      * Counts of the caller's connected Microsoft 365 sources (mail, files, sites, chats) plus live SharePoint provisioning progress. Built for computer-asset apps to render a 'setting up your sources' state right after a viewer's first sign-in, while the background fan-outs are still filling in SharePoint and Teams.
      *

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

@@ -79,6 +79,70 @@ export class UsersClient {
             }
         });
     }
+    /**
+     * The caller's email preferences for agent-sent mail in their current workspace: the domains and specific addresses they have approved as recipients, plus their custom drafting instruction. Built for computer-asset apps that compose or send email on the user's behalf, so they apply the same recipient policy the chat email tools enforce — a recipient is approved when its full address is in `approved_emails` or its domain is in `approved_domains` (both compared case-insensitively). Read-only: the policy is edited from Settings → Email & Meetings (`manage_url`).
+     *
+     * @param {UsersClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.users.meEmailPreferences()
+     */
+    meEmailPreferences(requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__meEmailPreferences(requestOptions));
+    }
+    __meEmailPreferences(requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({
+                "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,
+            }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield ((_d = this._options.fetcher) !== null && _d !== void 0 ? _d : core.fetcher)({
+                url: core.url.join((_f = (_e = (yield core.Supplier.get(this._options.baseUrl))) !== null && _e !== void 0 ? _e : (yield core.Supplier.get(this._options.environment))) !== null && _f !== void 0 ? _f : environments.AthenaIntelligenceEnvironment.Production, "api/v0/me/email-preferences"),
+                method: "GET",
+                headers: _headers,
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                timeoutMs: ((_j = (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.timeoutInSeconds) !== null && _j !== void 0 ? _j : 60) * 1000,
+                maxRetries: (_k = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _k !== void 0 ? _k : (_l = this._options) === null || _l === void 0 ? void 0 : _l.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_m = this._options) === null || _m === void 0 ? void 0 : _m.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: _response.body,
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                throw new errors.AthenaIntelligenceError({
+                    statusCode: _response.error.statusCode,
+                    body: _response.error.body,
+                    rawResponse: _response.rawResponse,
+                });
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.AthenaIntelligenceError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "body-is-null":
+                    throw new errors.AthenaIntelligenceError({
+                        statusCode: _response.error.statusCode,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.AthenaIntelligenceTimeoutError("Timeout exceeded when calling GET /api/v0/me/email-preferences.");
+                case "unknown":
+                    throw new errors.AthenaIntelligenceError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
     /**
      * Counts of the caller's connected Microsoft 365 sources (mail, files, sites, chats) plus live SharePoint provisioning progress. Built for computer-asset apps to render a 'setting up your sources' state right after a viewer's first sign-in, while the background fan-outs are still filling in SharePoint and Teams.
      *

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

@@ -0,0 +1,13 @@
+/**
+ * The caller's approved-recipient policy for agent-sent email.
+ */
+export interface MeEmailPreferencesResponseOut {
+    /** Domains the agent may email anyone at, as bare lowercase domains (`acme.com`). Match a recipient's domain against this list. */
+    approved_domains: string[];
+    /** Specific addresses the agent may email, lowercase (`user@acme.com`). Match the whole recipient address against this list. */
+    approved_emails: string[];
+    /** Free-text guidance the user wants followed whenever an agent drafts email on their behalf; null when none is set. */
+    custom_instruction?: string | null;
+    /** Where the user edits this policy (Settings → Email & Meetings). Send the user here when a recipient is not approved; the policy cannot be changed through this API. */
+    manage_url: string;
+}

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

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

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

@@ -83,6 +83,7 @@ export * from "./InitializationRecipeStage.mjs";
 export * from "./InitializationState.mjs";
 export * from "./InputMessage.mjs";
 export * from "./InputMessageContentOneItem.mjs";
+export * from "./MeEmailPreferencesResponseOut.mjs";
 export * from "./MeetingArtifactsOut.mjs";
 export * from "./MeetingOut.mjs";
 export * from "./MeetingParticipantOut.mjs";

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

@@ -83,6 +83,7 @@ export * from "./InitializationRecipeStage.mjs";
 export * from "./InitializationState.mjs";
 export * from "./InputMessage.mjs";
 export * from "./InputMessageContentOneItem.mjs";
+export * from "./MeEmailPreferencesResponseOut.mjs";
 export * from "./MeetingArtifactsOut.mjs";
 export * from "./MeetingOut.mjs";
 export * from "./MeetingParticipantOut.mjs";

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "4.3.2214";
+export declare const SDK_VERSION = "4.3.2216";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "4.3.2214";
+export const SDK_VERSION = "4.3.2216";

package/package.json

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

package/reference.md

@@ -2879,6 +2879,61 @@ await client.users.me();
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.users.<a href="/src/api/resources/users/client/Client.ts">meEmailPreferences</a>() -> AthenaIntelligence.MeEmailPreferencesResponseOut</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+The caller's email preferences for agent-sent mail in their current workspace: the domains and specific addresses they have approved as recipients, plus their custom drafting instruction. Built for computer-asset apps that compose or send email on the user's behalf, so they apply the same recipient policy the chat email tools enforce — a recipient is approved when its full address is in `approved_emails` or its domain is in `approved_domains` (both compared case-insensitively). Read-only: the policy is edited from Settings → Email & Meetings (`manage_url`).
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.users.meEmailPreferences();
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**requestOptions:** `UsersClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>