@athenaintel/sdk 4.3.2158 → 4.3.2159

package/dist/esm/api/resources/tools/resources/email/client/requests/EmailDraftRequestIn.d.mts

@@ -0,0 +1,27 @@
+/**
+ * @example
+ *     {
+ *         body: "Hi Ada,<br><br>Attached below is the Q3 forecast summary.",
+ *         cc: ["grace@example.com"],
+ *         subject: "Q3 forecast",
+ *         to: ["ada@example.com"]
+ *     }
+ */
+export interface EmailDraftRequestIn {
+    /** BCC recipients. */
+    bcc?: string[] | null;
+    /** Body content. HTML is supported; plain-text newlines become line breaks. Do not write a signature into it — the account's signature is appended automatically (see `include_signature`). */
+    body: string;
+    /** 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;
+    /** CC recipients. */
+    cc?: string[] | null;
+    /** Optional: Whether to append the sending account's own signature at the end of the body. Leave unset to follow the user's saved preference for this account (which distinguishes new messages from replies) — that is almost always the right choice. Set false only when the user asks for no signature. Never write a signature into the body yourself: the real one is read from the account and appended automatically. */
+    include_signature?: boolean | null;
+    /** Provider message id (from `GET /tools/email/search`) to reply to, so the draft is threaded under that message. Outlook rejects an id it cannot find (404). Gmail saves the draft *unthreaded* when the referenced message cannot be read, and `reply_to_message_id` in the response tells you which happened. */
+    reply_to_message_id?: string | null;
+    /** Subject line. */
+    subject: string;
+    /** Recipient email addresses. */
+    to: string[];
+}

package/dist/esm/api/resources/tools/resources/email/client/requests/EmailDraftRequestIn.mjs

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

package/dist/esm/api/resources/tools/resources/email/client/requests/SearchEmailRequest.d.mts

@@ -0,0 +1,15 @@
+/**
+ * @example
+ *     {
+ *         query: "from:ada@example.com newer_than:7d",
+ *         limit: 20
+ *     }
+ */
+export interface SearchEmailRequest {
+    /** Search query. Gmail operators (`from:`, `to:`, `subject:`, `has:attachment`, `newer_than:7d`, `-term`, …) are accepted for both providers; operators with no Outlook equivalent are dropped and reported in `ignored_operators`. Use `in:drafts` to search only unsent drafts. */
+    query: string;
+    /** 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;
+    /** Maximum number of results (1-50). */
+    limit?: number;
+}

package/dist/esm/api/resources/tools/resources/email/client/requests/SearchEmailRequest.mjs

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

package/dist/esm/api/resources/tools/resources/email/client/requests/index.d.mts

@@ -0,0 +1,2 @@
+export type { EmailDraftRequestIn } from "./EmailDraftRequestIn.mjs";
+export type { SearchEmailRequest } from "./SearchEmailRequest.mjs";

package/dist/esm/api/resources/tools/resources/email/client/requests/index.mjs

@@ -0,0 +1 @@
+export {};

package/dist/esm/api/resources/tools/resources/index.d.mts

@@ -1,4 +1,6 @@
+export * from "./calendar/client/requests/index.mjs";
 export * as calendar from "./calendar/index.mjs";
+export * from "./email/client/requests/index.mjs";
 export * as email from "./email/index.mjs";
 export * from "./sheets/client/requests/index.mjs";
 export * as sheets from "./sheets/index.mjs";

package/dist/esm/api/resources/tools/resources/index.mjs

@@ -1,4 +1,6 @@
+export * from "./calendar/client/requests/index.mjs";
 export * as calendar from "./calendar/index.mjs";
+export * from "./email/client/requests/index.mjs";
 export * as email from "./email/index.mjs";
 export * from "./sheets/client/requests/index.mjs";
 export * as sheets from "./sheets/index.mjs";

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

@@ -0,0 +1,11 @@
+/**
+ * One attendee of a calendar event.
+ */
+export interface CalendarAttendeeOut {
+    /** Attendee email address. */
+    email?: string;
+    /** Attendee display name, if known. */
+    name?: string;
+    /** Attendee response, in the provider's vocabulary. */
+    response_status?: string;
+}

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

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

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

@@ -0,0 +1,28 @@
+import type * as AthenaIntelligence from "../index.mjs";
+/**
+ * One calendar event.
+ */
+export interface CalendarEventOut {
+    /** Attendees and their responses. */
+    attendees?: AthenaIntelligence.CalendarAttendeeOut[];
+    /** Meet / Teams / other conferencing join link, if any. */
+    conferencing_url?: string;
+    /** Description or body preview. */
+    description?: string;
+    /** End time, ISO 8601. */
+    end?: string;
+    /** Link to the event in Google Calendar. Gmail accounts only. */
+    html_link?: string | null;
+    /** Provider event id. */
+    id: string;
+    /** Location, if set. */
+    location?: string;
+    /** Start time, ISO 8601. */
+    start?: string;
+    /** Event status. Gmail accounts only. */
+    status?: string | null;
+    /** Event title. */
+    title?: string;
+    /** Link to the event in Outlook. Outlook accounts only. */
+    web_link?: string | null;
+}

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

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

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

@@ -0,0 +1,14 @@
+import type * as AthenaIntelligence from "../index.mjs";
+/**
+ * Result of `GET /tools/calendar/events`.
+ */
+export interface CalendarEventsResponseOut {
+    /** The connected account that was read. */
+    catalog_id: string;
+    /** Number of events returned. */
+    count: number;
+    /** Account provider as Athena reports it: `gmail` or `outlook` for accounts connected through the Integrations page; `google` or `microsoft365` for directly-connected accounts (read-only for drafts). */
+    provider: string;
+    /** Matching events in ascending start order. */
+    results?: AthenaIntelligence.CalendarEventOut[];
+}

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

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

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

@@ -0,0 +1,23 @@
+/**
+ * Result of `POST /tools/email/draft`.
+ */
+export interface EmailDraftResponseOut {
+    /** The connected account the draft is in. */
+    catalog_id: string;
+    /** Provider draft id. Open, edit, or send it in the mail client. */
+    draft_id?: string | null;
+    /** The address the draft will be sent from. */
+    email_address?: string | null;
+    /** Human-readable outcome, when the provider reports one. */
+    message?: string | null;
+    /** Provider message id backing the draft. Gmail accounts only. */
+    message_id?: string | null;
+    /** Account provider as Athena reports it: `gmail` or `outlook` for accounts connected through the Integrations page; `google` or `microsoft365` for directly-connected accounts (read-only for drafts). */
+    provider: string;
+    /** The message this draft replies to, when it is a reply. */
+    reply_to_message_id?: string | null;
+    /** Whether the draft was saved. */
+    success: boolean;
+    /** Athena email-tracking id, when tracking is enabled on the account. */
+    tracking_id?: string | null;
+}

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

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

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

@@ -0,0 +1,22 @@
+import type * as AthenaIntelligence from "../index.mjs";
+/**
+ * Result of `GET /tools/email/search`.
+ */
+export interface EmailSearchResponseOut {
+    /** The connected account that was searched. */
+    catalog_id: string;
+    /** Number of results returned. */
+    count: number;
+    /** How many of the results are unsent drafts. */
+    draft_count?: number;
+    /** Gmail search operators that have no Outlook equivalent and were dropped from the query. Outlook accounts only. */
+    ignored_operators?: string[] | null;
+    /** Human-readable caveats about the results, when there are any. */
+    note?: string | null;
+    /** Account provider as Athena reports it: `gmail` or `outlook` for accounts connected through the Integrations page; `google` or `microsoft365` for directly-connected accounts (read-only for drafts). */
+    provider: string;
+    /** The query as executed. */
+    query: string;
+    /** Matching messages, newest first. */
+    results?: AthenaIntelligence.EmailSearchResultOut[];
+}

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

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

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

@@ -0,0 +1,25 @@
+/**
+ * One message matched by an email search.
+ */
+export interface EmailSearchResultOut {
+    /** Microsoft Graph conversation id. Outlook accounts only. */
+    conversation_id?: string | null;
+    /** Sent or received timestamp, in the provider's format. */
+    date?: string;
+    /** Provider draft id, when the provider exposes one for a draft. */
+    draft_id?: string | null;
+    /** Sender, as the provider reports it. */
+    from?: string;
+    /** Provider message id (Gmail message id, or Microsoft Graph message id for Outlook). This — never an Athena asset id — is what `reply_to_message_id` accepts. */
+    id: string;
+    /** True when the message is an unsent draft sitting in the mailbox. Drafts are never sent or received mail and cannot be replied to. */
+    is_draft?: boolean;
+    /** Short plain-text preview. */
+    snippet?: string;
+    /** Subject line. */
+    subject?: string;
+    /** Gmail thread id. Gmail accounts only. */
+    thread_id?: string | null;
+    /** Recipients, comma-separated as the provider reports them. */
+    to?: string;
+}

package/dist/esm/api/types/EmailSearchResultOut.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

@@ -23,6 +23,9 @@ export * from "./AssetScreenshotResponseOut.mjs";
 export * from "./BorderModel.mjs";
 export * from "./BorderStyle.mjs";
 export * from "./BordersModel.mjs";
+export * from "./CalendarAttendeeOut.mjs";
+export * from "./CalendarEventOut.mjs";
+export * from "./CalendarEventsResponseOut.mjs";
 export * from "./CellFormat.mjs";
 export * from "./Chunk.mjs";
 export * from "./ChunkContentItem.mjs";
@@ -56,6 +59,9 @@ export * from "./DeployComputerResponseOut.mjs";
 export * from "./DimensionProperties.mjs";
 export * from "./DriveAgentResponse.mjs";
 export * from "./DuplicateAssetResponseOut.mjs";
+export * from "./EmailDraftResponseOut.mjs";
+export * from "./EmailSearchResponseOut.mjs";
+export * from "./EmailSearchResultOut.mjs";
 export * from "./FileTooLargeError.mjs";
 export * from "./FolderResponse.mjs";
 export * from "./GeneralAgentConfig.mjs";

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

@@ -23,6 +23,9 @@ export * from "./AssetScreenshotResponseOut.mjs";
 export * from "./BorderModel.mjs";
 export * from "./BorderStyle.mjs";
 export * from "./BordersModel.mjs";
+export * from "./CalendarAttendeeOut.mjs";
+export * from "./CalendarEventOut.mjs";
+export * from "./CalendarEventsResponseOut.mjs";
 export * from "./CellFormat.mjs";
 export * from "./Chunk.mjs";
 export * from "./ChunkContentItem.mjs";
@@ -56,6 +59,9 @@ export * from "./DeployComputerResponseOut.mjs";
 export * from "./DimensionProperties.mjs";
 export * from "./DriveAgentResponse.mjs";
 export * from "./DuplicateAssetResponseOut.mjs";
+export * from "./EmailDraftResponseOut.mjs";
+export * from "./EmailSearchResponseOut.mjs";
+export * from "./EmailSearchResultOut.mjs";
 export * from "./FileTooLargeError.mjs";
 export * from "./FolderResponse.mjs";
 export * from "./GeneralAgentConfig.mjs";

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "4.3.2158";
+export declare const SDK_VERSION = "4.3.2159";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "4.3.2158";
+export const SDK_VERSION = "4.3.2159";

package/package.json

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

package/reference.md

@@ -5187,7 +5187,7 @@ await client.agents.sql.invoke({
 </details>
 
 ## Tools Calendar
-<details><summary><code>client.tools.calendar.<a href="/src/api/resources/tools/resources/calendar/client/Client.ts">listEvents</a>() -> unknown</code></summary>
+<details><summary><code>client.tools.calendar.<a href="/src/api/resources/tools/resources/calendar/client/Client.ts">listEvents</a>({ ...params }) -> AthenaIntelligence.CalendarEventsResponseOut</code></summary>
 <dl>
 <dd>
 
@@ -5199,7 +5199,13 @@ await client.agents.sql.invoke({
 <dl>
 <dd>
 
-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.
 </dd>
 </dl>
 </dd>
@@ -5214,7 +5220,9 @@ Coming soon! List calendar events with optional filtering.
 <dd>
 
 ```typescript
-await client.tools.calendar.listEvents();
+await client.tools.calendar.listEvents({
+    limit: 50
+});
 
 ```
 </dd>
@@ -5230,58 +5238,11 @@ await client.tools.calendar.listEvents();
 <dl>
 <dd>
 
-**requestOptions:** `CalendarClient.RequestOptions` 
+**request:** `AthenaIntelligence.tools.ListEventsCalendarRequest` 
     
-</dd>
-</dl>
-</dd>
-</dl>
-
-
-</dd>
-</dl>
-</details>
-
-<details><summary><code>client.tools.calendar.<a href="/src/api/resources/tools/resources/calendar/client/Client.ts">createEvent</a>() -> unknown</code></summary>
-<dl>
-<dd>
-
-#### 📝 Description
-
-<dl>
-<dd>
-
-<dl>
-<dd>
-
-Coming soon! Create new calendar events.
-</dd>
-</dl>
 </dd>
 </dl>
 
-#### 🔌 Usage
-
-<dl>
-<dd>
-
-<dl>
-<dd>
-
-```typescript
-await client.tools.calendar.createEvent();
-
-```
-</dd>
-</dl>
-</dd>
-</dl>
-
-#### ⚙️ Parameters
-
-<dl>
-<dd>
-
 <dl>
 <dd>
 
@@ -5298,7 +5259,7 @@ await client.tools.calendar.createEvent();
 </details>
 
 ## Tools Email
-<details><summary><code>client.tools.email.<a href="/src/api/resources/tools/resources/email/client/Client.ts">createDraft</a>() -> unknown</code></summary>
+<details><summary><code>client.tools.email.<a href="/src/api/resources/tools/resources/email/client/Client.ts">createDraft</a>({ ...params }) -> AthenaIntelligence.EmailDraftResponseOut</code></summary>
 <dl>
 <dd>
 
@@ -5310,7 +5271,12 @@ await client.tools.calendar.createEvent();
 <dl>
 <dd>
 
-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.
 </dd>
 </dl>
 </dd>
@@ -5325,7 +5291,12 @@ Coming soon! Create email drafts with specified content and recipients.
 <dd>
 
 ```typescript
-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"]
+});
 
 ```
 </dd>
@@ -5341,57 +5312,10 @@ await client.tools.email.createDraft();
 <dl>
 <dd>
 
-**requestOptions:** `EmailClient.RequestOptions` 
+**request:** `AthenaIntelligence.tools.EmailDraftRequestIn` 
     
 </dd>
 </dl>
-</dd>
-</dl>
-
-
-</dd>
-</dl>
-</details>
-
-<details><summary><code>client.tools.email.<a href="/src/api/resources/tools/resources/email/client/Client.ts">search</a>() -> unknown</code></summary>
-<dl>
-<dd>
-
-#### 📝 Description
-
-<dl>
-<dd>
-
-<dl>
-<dd>
-
-Coming soon! Search through emails with configurable filters.
-</dd>
-</dl>
-</dd>
-</dl>
-
-#### 🔌 Usage
-
-<dl>
-<dd>
-
-<dl>
-<dd>
-
-```typescript
-await client.tools.email.search();
-
-```
-</dd>
-</dl>
-</dd>
-</dl>
-
-#### ⚙️ Parameters
-
-<dl>
-<dd>
 
 <dl>
 <dd>
@@ -5408,7 +5332,7 @@ await client.tools.email.search();
 </dl>
 </details>
 
-<details><summary><code>client.tools.email.<a href="/src/api/resources/tools/resources/email/client/Client.ts">send</a>() -> unknown</code></summary>
+<details><summary><code>client.tools.email.<a href="/src/api/resources/tools/resources/email/client/Client.ts">search</a>({ ...params }) -> AthenaIntelligence.EmailSearchResponseOut</code></summary>
 <dl>
 <dd>
 
@@ -5420,7 +5344,11 @@ await client.tools.email.search();
 <dl>
 <dd>
 
-Coming soon! Send emails to specified recipients.
+Search the caller's connected Gmail or Outlook mailbox.
+
+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`.
 </dd>
 </dl>
 </dd>
@@ -5435,7 +5363,10 @@ Coming soon! Send emails to specified recipients.
 <dd>
 
 ```typescript
-await client.tools.email.send();
+await client.tools.email.search({
+    query: "from:ada@example.com newer_than:7d",
+    limit: 20
+});
 
 ```
 </dd>
@@ -5451,6 +5382,14 @@ await client.tools.email.send();
 <dl>
 <dd>
 
+**request:** `AthenaIntelligence.tools.SearchEmailRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
 **requestOptions:** `EmailClient.RequestOptions` 
     
 </dd>