@athenaintel/sdk 4.3.2158 → 4.3.2159

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

package/dist/cjs/api/errors/TooManyRequestsError.d.ts

@@ -1,5 +1,5 @@
 import type * as core from "../../core/index.js";
 import * as errors from "../../errors/index.js";
 export declare class TooManyRequestsError extends errors.AthenaIntelligenceError {
-    constructor(body: Record<string, unknown>, rawResponse?: core.RawResponse);
+    constructor(body?: unknown, rawResponse?: core.RawResponse);
 }

package/dist/cjs/api/resources/tools/resources/calendar/client/Client.d.ts

@@ -1,6 +1,7 @@
 import type { BaseClientOptions, BaseRequestOptions } from "../../../../../../BaseClient.js";
 import { type NormalizedClientOptionsWithAuth } from "../../../../../../BaseClient.js";
 import * as core from "../../../../../../core/index.js";
+import * as AthenaIntelligence from "../../../../../index.js";
 export declare namespace CalendarClient {
     interface Options extends BaseClientOptions {
     }
@@ -11,23 +12,29 @@ export declare class CalendarClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<CalendarClient.Options>;
     constructor(options?: CalendarClient.Options);
     /**
-     * Coming soon! List calendar events with optional filtering.
+     * List events on the calendar of the caller's connected account.
      *
-     * @param {CalendarClient.RequestOptions} requestOptions - Request-specific configuration.
-     *
-     * @example
-     *     await client.tools.calendar.listEvents()
-     */
-    listEvents(requestOptions?: CalendarClient.RequestOptions): core.HttpResponsePromise<unknown>;
-    private __listEvents;
-    /**
-     * Coming soon! Create new calendar events.
+     * Reads the primary Google Calendar of a Gmail account or the default calendar
+     * of an Outlook account. `start`/`end` select the events overlapping that
+     * window; without them, Outlook returns recurring series as single entries, so
+     * supply a window to expand them. `title`, `location` and `attendees` filter the
+     * events that were read.
      *
+     * @param {AthenaIntelligence.tools.ListEventsCalendarRequest} request
      * @param {CalendarClient.RequestOptions} requestOptions - Request-specific configuration.
      *
+     * @throws {@link AthenaIntelligence.BadRequestError}
+     * @throws {@link AthenaIntelligence.ForbiddenError}
+     * @throws {@link AthenaIntelligence.NotFoundError}
+     * @throws {@link AthenaIntelligence.UnprocessableEntityError}
+     * @throws {@link AthenaIntelligence.TooManyRequestsError}
+     * @throws {@link AthenaIntelligence.BadGatewayError}
+     *
      * @example
-     *     await client.tools.calendar.createEvent()
+     *     await client.tools.calendar.listEvents({
+     *         limit: 50
+     *     })
      */
-    createEvent(requestOptions?: CalendarClient.RequestOptions): core.HttpResponsePromise<unknown>;
-    private __createEvent;
+    listEvents(request?: AthenaIntelligence.tools.ListEventsCalendarRequest, requestOptions?: CalendarClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.CalendarEventsResponseOut>;
+    private __listEvents;
 }

package/dist/cjs/api/resources/tools/resources/calendar/client/Client.js

@@ -49,90 +49,71 @@ const headers_js_1 = require("../../../../../../core/headers.js");
 const core = __importStar(require("../../../../../../core/index.js"));
 const environments = __importStar(require("../../../../../../environments.js"));
 const errors = __importStar(require("../../../../../../errors/index.js"));
+const AthenaIntelligence = __importStar(require("../../../../../index.js"));
 class CalendarClient {
     constructor(options = {}) {
         this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
     }
     /**
-     * Coming soon! List calendar events with optional filtering.
+     * List events on the calendar of the caller's connected account.
      *
+     * Reads the primary Google Calendar of a Gmail account or the default calendar
+     * of an Outlook account. `start`/`end` select the events overlapping that
+     * window; without them, Outlook returns recurring series as single entries, so
+     * supply a window to expand them. `title`, `location` and `attendees` filter the
+     * events that were read.
+     *
+     * @param {AthenaIntelligence.tools.ListEventsCalendarRequest} request
      * @param {CalendarClient.RequestOptions} requestOptions - Request-specific configuration.
      *
+     * @throws {@link AthenaIntelligence.BadRequestError}
+     * @throws {@link AthenaIntelligence.ForbiddenError}
+     * @throws {@link AthenaIntelligence.NotFoundError}
+     * @throws {@link AthenaIntelligence.UnprocessableEntityError}
+     * @throws {@link AthenaIntelligence.TooManyRequestsError}
+     * @throws {@link AthenaIntelligence.BadGatewayError}
+     *
      * @example
-     *     await client.tools.calendar.listEvents()
+     *     await client.tools.calendar.listEvents({
+     *         limit: 50
+     *     })
      */
-    listEvents(requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__listEvents(requestOptions));
+    listEvents(request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__listEvents(request, requestOptions));
     }
-    __listEvents(requestOptions) {
-        return __awaiter(this, void 0, void 0, function* () {
+    __listEvents() {
+        return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-            const _authRequest = yield this._options.authProvider.getAuthRequest();
-            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
-            const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
-                url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.AthenaIntelligenceEnvironment.Production, "api/v0/tools/calendar/events"),
-                method: "GET",
-                headers: _headers,
-                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
-                timeoutMs: ((_g = (_e = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _e !== void 0 ? _e : (_f = this._options) === null || _f === void 0 ? void 0 : _f.timeoutInSeconds) !== null && _g !== void 0 ? _g : 60) * 1000,
-                maxRetries: (_h = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _h !== void 0 ? _h : (_j = this._options) === null || _j === void 0 ? void 0 : _j.maxRetries,
-                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
-                fetchFn: (_k = this._options) === null || _k === void 0 ? void 0 : _k.fetch,
-                logging: this._options.logging,
-            });
-            if (_response.ok) {
-                return { data: _response.body, rawResponse: _response.rawResponse };
+            const { title, start, end, location, attendees, limit, catalog_id: catalogId } = request;
+            const _queryParams = {};
+            if (title !== undefined) {
+                _queryParams.title = title;
             }
-            if (_response.error.reason === "status-code") {
-                throw new errors.AthenaIntelligenceError({
-                    statusCode: _response.error.statusCode,
-                    body: _response.error.body,
-                    rawResponse: _response.rawResponse,
-                });
+            if (start !== undefined) {
+                _queryParams.start = start;
             }
-            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/tools/calendar/events.");
-                case "unknown":
-                    throw new errors.AthenaIntelligenceError({
-                        message: _response.error.errorMessage,
-                        rawResponse: _response.rawResponse,
-                    });
+            if (end !== undefined) {
+                _queryParams.end = end;
+            }
+            if (location !== undefined) {
+                _queryParams.location = location;
+            }
+            if (attendees !== undefined) {
+                _queryParams.attendees = attendees;
+            }
+            if (limit != null) {
+                _queryParams.limit = limit.toString();
+            }
+            if (catalogId !== undefined) {
+                _queryParams.catalog_id = catalogId;
             }
-        });
-    }
-    /**
-     * Coming soon! Create new calendar events.
-     *
-     * @param {CalendarClient.RequestOptions} requestOptions - Request-specific configuration.
-     *
-     * @example
-     *     await client.tools.calendar.createEvent()
-     */
-    createEvent(requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__createEvent(requestOptions));
-    }
-    __createEvent(requestOptions) {
-        return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
             const _authRequest = yield this._options.authProvider.getAuthRequest();
             const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
                 url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.AthenaIntelligenceEnvironment.Production, "api/v0/tools/calendar/events"),
-                method: "POST",
+                method: "GET",
                 headers: _headers,
-                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
                 timeoutMs: ((_g = (_e = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _e !== void 0 ? _e : (_f = this._options) === null || _f === void 0 ? void 0 : _f.timeoutInSeconds) !== null && _g !== void 0 ? _g : 60) * 1000,
                 maxRetries: (_h = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _h !== void 0 ? _h : (_j = this._options) === null || _j === void 0 ? void 0 : _j.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
@@ -140,14 +121,32 @@ class CalendarClient {
                 logging: this._options.logging,
             });
             if (_response.ok) {
-                return { data: _response.body, rawResponse: _response.rawResponse };
+                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.statusCode) {
+                    case 400:
+                        throw new AthenaIntelligence.BadRequestError(_response.error.body, _response.rawResponse);
+                    case 403:
+                        throw new AthenaIntelligence.ForbiddenError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new AthenaIntelligence.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 422:
+                        throw new AthenaIntelligence.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                    case 429:
+                        throw new AthenaIntelligence.TooManyRequestsError(_response.error.body, _response.rawResponse);
+                    case 502:
+                        throw new AthenaIntelligence.BadGatewayError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.AthenaIntelligenceError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
             }
             switch (_response.error.reason) {
                 case "non-json":
@@ -162,7 +161,7 @@ class CalendarClient {
                         rawResponse: _response.rawResponse,
                     });
                 case "timeout":
-                    throw new errors.AthenaIntelligenceTimeoutError("Timeout exceeded when calling POST /api/v0/tools/calendar/events.");
+                    throw new errors.AthenaIntelligenceTimeoutError("Timeout exceeded when calling GET /api/v0/tools/calendar/events.");
                 case "unknown":
                     throw new errors.AthenaIntelligenceError({
                         message: _response.error.errorMessage,

package/dist/cjs/api/resources/tools/resources/calendar/client/index.d.ts

@@ -1 +1 @@
-export {};
+export * from "./requests/index.js";

package/dist/cjs/api/resources/tools/resources/calendar/client/index.js

@@ -1,2 +1,17 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./requests/index.js"), exports);

package/dist/cjs/api/resources/tools/resources/calendar/client/requests/ListEventsCalendarRequest.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @example
+ *     {
+ *         limit: 50
+ *     }
+ */
+export interface ListEventsCalendarRequest {
+    /** Text filter. On Outlook this matches the event title only (`contains(subject, …)`); on Google Calendar it is Google's free-text event search (`q`), which also matches the description, location and attendee names. */
+    title?: string | null;
+    /** Window start. `start` and `end` select events that overlap the window: an event that begins before `start` but is still running at `start` is included. ISO 8601 with an explicit UTC offset or Z (e.g. `2026-10-01T00:00:00-04:00`); the instant is forwarded in RFC 3339 form. Recurring series are expanded into their instances inside the window. Given only one bound, Google leaves the other side open while Outlook derives it 60 days away. */
+    start?: string | null;
+    /** Window end (see `start`); must be later than `start` when both are given. ISO 8601 with an explicit UTC offset or Z. */
+    end?: string | null;
+    /** Only events whose location contains this text. Applied after up to `limit` events have been read from the provider, so narrow the window with `start`/`end` when looking for a specific event. */
+    location?: string | null;
+    /** Only events with at least one of these attendee emails (comma-separated). Applied after up to `limit` events have been read from the provider, so narrow the window with `start`/`end` when looking for a specific event. */
+    attendees?: string | null;
+    /** Maximum number of events (1-200). */
+    limit?: number;
+    /** 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. */
+    catalog_id?: string | null;
+}

package/dist/cjs/api/resources/tools/resources/calendar/client/requests/ListEventsCalendarRequest.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/resources/tools/resources/calendar/client/requests/index.d.ts

@@ -0,0 +1 @@
+export type { ListEventsCalendarRequest } from "./ListEventsCalendarRequest.js";

package/dist/cjs/api/resources/tools/resources/calendar/client/requests/index.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/tools/resources/email/client/Client.d.ts

@@ -1,6 +1,7 @@
 import type { BaseClientOptions, BaseRequestOptions } from "../../../../../../BaseClient.js";
 import { type NormalizedClientOptionsWithAuth } from "../../../../../../BaseClient.js";
 import * as core from "../../../../../../core/index.js";
+import * as AthenaIntelligence from "../../../../../index.js";
 export declare namespace EmailClient {
     interface Options extends BaseClientOptions {
     }
@@ -11,33 +12,56 @@ export declare class EmailClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<EmailClient.Options>;
     constructor(options?: EmailClient.Options);
     /**
-     * Coming soon! Create email drafts with specified content and recipients.
+     * Save a draft in the caller's connected Gmail or Outlook account.
      *
+     * Nothing is sent. The draft appears in the account's Drafts folder, where it
+     * is reviewed, edited and sent from the mail client — that review step is why
+     * drafting is available here while sending is not. Set `reply_to_message_id`
+     * to thread the draft as a reply.
+     *
+     * @param {AthenaIntelligence.tools.EmailDraftRequestIn} request
      * @param {EmailClient.RequestOptions} requestOptions - Request-specific configuration.
      *
+     * @throws {@link AthenaIntelligence.BadRequestError}
+     * @throws {@link AthenaIntelligence.ForbiddenError}
+     * @throws {@link AthenaIntelligence.NotFoundError}
+     * @throws {@link AthenaIntelligence.UnprocessableEntityError}
+     * @throws {@link AthenaIntelligence.TooManyRequestsError}
+     * @throws {@link AthenaIntelligence.BadGatewayError}
+     *
      * @example
-     *     await client.tools.email.createDraft()
+     *     await client.tools.email.createDraft({
+     *         body: "Hi Ada,<br><br>Attached below is the Q3 forecast summary.",
+     *         cc: ["grace@example.com"],
+     *         subject: "Q3 forecast",
+     *         to: ["ada@example.com"]
+     *     })
      */
-    createDraft(requestOptions?: EmailClient.RequestOptions): core.HttpResponsePromise<unknown>;
+    createDraft(request: AthenaIntelligence.tools.EmailDraftRequestIn, requestOptions?: EmailClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.EmailDraftResponseOut>;
     private __createDraft;
     /**
-     * Coming soon! Search through emails with configurable filters.
+     * Search the caller's connected Gmail or Outlook mailbox.
      *
-     * @param {EmailClient.RequestOptions} requestOptions - Request-specific configuration.
-     *
-     * @example
-     *     await client.tools.email.search()
-     */
-    search(requestOptions?: EmailClient.RequestOptions): core.HttpResponsePromise<unknown>;
-    private __search;
-    /**
-     * Coming soon! Send emails to specified recipients.
+     * Results come from the connected account the caller can access in their
+     * current workspace (the default account unless `catalog_id` names another).
+     * Unsent drafts are included and flagged with `is_draft`.
      *
+     * @param {AthenaIntelligence.tools.SearchEmailRequest} request
      * @param {EmailClient.RequestOptions} requestOptions - Request-specific configuration.
      *
+     * @throws {@link AthenaIntelligence.BadRequestError}
+     * @throws {@link AthenaIntelligence.ForbiddenError}
+     * @throws {@link AthenaIntelligence.NotFoundError}
+     * @throws {@link AthenaIntelligence.UnprocessableEntityError}
+     * @throws {@link AthenaIntelligence.TooManyRequestsError}
+     * @throws {@link AthenaIntelligence.BadGatewayError}
+     *
      * @example
-     *     await client.tools.email.send()
+     *     await client.tools.email.search({
+     *         query: "from:ada@example.com newer_than:7d",
+     *         limit: 20
+     *     })
      */
-    send(requestOptions?: EmailClient.RequestOptions): core.HttpResponsePromise<unknown>;
-    private __send;
+    search(request: AthenaIntelligence.tools.SearchEmailRequest, requestOptions?: EmailClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.EmailSearchResponseOut>;
+    private __search;
 }