@epilot/sdk 2.18.14 → 2.18.16

package/dist/{message.d-b-UwZUNb.d.ts → message.d-BHWCGH3q.d.ts}

@@ -339,6 +339,49 @@ declare namespace Components {
              */
             template_id?: string;
         }
+        export interface MessageAutoReplySentEvent {
+            type: "MESSAGE_AUTO_REPLY_SENT";
+            /**
+             * ID of the message that was sent as the automatic reply
+             */
+            reply_message_id?: string;
+            /**
+             * ID of the message the automatic reply responded to
+             */
+            parent_message_id?: string;
+        }
+        export interface MessageEntityLinkedEvent {
+            type: "MESSAGE_ENTITY_LINKED";
+            entities?: TimelineLinkedEntity[];
+            link_kind?: "manual" | "auto";
+        }
+        export interface MessageEntityUnlinkedEvent {
+            type: "MESSAGE_ENTITY_UNLINKED";
+            entities?: TimelineLinkedEntity[];
+            link_kind?: "manual" | "auto";
+        }
+        export interface MessageLabelAddedEvent {
+            type: "MESSAGE_LABEL_ADDED";
+            /**
+             * The label that was added (raw tag slug, e.g. `sentiments:angry`)
+             */
+            label: string;
+            /**
+             * Resolved taxonomy classification display name (e.g. `Verärgert`), when the label is a classification. Absent for free-form tags.
+             */
+            label_name?: string;
+        }
+        export interface MessageLabelRemovedEvent {
+            type: "MESSAGE_LABEL_REMOVED";
+            /**
+             * The label that was removed (raw tag slug, e.g. `sentiments:angry`)
+             */
+            label: string;
+            /**
+             * Resolved taxonomy classification display name (e.g. `Verärgert`), when the label is a classification. Absent for free-form tags.
+             */
+            label_name?: string;
+        }
         export interface MessageRequestParams {
             [name: string]: any;
             /**
@@ -721,6 +764,17 @@ declare namespace Components {
              */
             organization_id: string;
         }
+        export interface ThreadMovedToInboxEvent {
+            type: "THREAD_MOVED_TO_INBOX";
+            /**
+             * ID of the shared inbox the thread was moved to
+             */
+            target_inbox_id?: string;
+            /**
+             * Name of the shared inbox the thread was moved to
+             */
+            target_inbox_name?: string;
+        }
         export interface ThreadOpenEvent {
             type: "THREAD_OPEN";
             /**
@@ -736,19 +790,206 @@ declare namespace Components {
              */
             organization_id: string;
         }
+        export interface ThreadRestoredEvent {
+            type: "THREAD_RESTORED";
+        }
         export interface ThreadTimeline {
             events: TimelineEvent[];
         }
+        export interface ThreadTrashedEvent {
+            type: "THREAD_TRASHED";
+        }
+        export interface ThreadUserAssignedEvent {
+            type: "THREAD_USER_ASSIGNED";
+            /**
+             * User IDs assigned to the thread
+             */
+            added?: string[];
+            /**
+             * User IDs unassigned from the thread
+             */
+            removed?: string[];
+        }
+        export interface TimelineActor {
+            user_id?: string;
+            email?: string;
+        }
         export interface TimelineEvent {
+            /**
+             * Activity id (ActivityItem._id), for deep-linking to the item in the activity feed
+             */
+            id?: string;
             data: TimelineEventData;
             /**
              * Timestamp of the event
              * example:
-             * 2024-01-01T00:00:00.000Z
+             * 2024-01-01T00:00:00Z
              */
             timestamp: string;
+            /**
+             * For message-level events, the message the activity is anchored to
+             */
+            message_id?: string;
+            source?: "user" | "automation" | "system";
+            /**
+             * Whether the activity was performed automatically (automation/system)
+             */
+            automated?: boolean;
+            actor?: TimelineActor;
+            automation?: {
+                id?: string;
+                name?: string;
+            };
+        }
+        export type TimelineEventData = ThreadDoneEvent | ThreadOpenEvent | WorkflowStartedEvent | ThreadUserAssignedEvent | MessageLabelAddedEvent | MessageLabelRemovedEvent | MessageEntityLinkedEvent | MessageEntityUnlinkedEvent | MessageAutoReplySentEvent | ThreadMovedToInboxEvent | ThreadTrashedEvent | ThreadRestoredEvent;
+        export interface TimelineLinkedEntity {
+            entity_id: string;
+            /**
+             * Entity schema slug, e.g. "opportunity"
+             */
+            schema?: string;
+        }
+        export interface UnreadCountBuckets {
+            /**
+             * example:
+             * 14
+             */
+            unread: number;
+            /**
+             * Organization scope only.
+             * example:
+             * 12
+             */
+            drafts?: number;
+            /**
+             * Organization scope only.
+             * example:
+             * 1
+             */
+            unassigned?: number;
+            /**
+             * Organization scope only.
+             * example:
+             * 3
+             */
+            spam?: number;
+        }
+        export interface UnreadCountScope {
+            /**
+             * Caller-chosen key for this scope. Echoed back as the key in `counts`, so it is how the
+             * caller matches a number to the sidebar row it belongs to. Must be unique within the
+             * request; duplicates are refused rather than silently collapsed.
+             *
+             * example:
+             * inbox-support
+             */
+            name: string;
+            /**
+             * Decides which buckets come back, and whether `q` is required. `organization` returns all
+             * four buckets from the canonical central-inbox queries and takes no `q`. `shared_inbox`
+             * and `saved_view` return `unread` alone and require the `q` their list uses.
+             *
+             * A `shared_inbox` scope additionally requires `actor: organization` and is refused with a
+             * 400 otherwise. A shared inbox is an organization-level construct — selecting one always
+             * switches the mailbox to the organization — so it has no per-user read state and the
+             * combination would compute a number no surface renders. `saved_view` accepts either actor,
+             * because a view's own configuration names its mailbox.
+             *
+             */
+            type: "organization" | "shared_inbox" | "saved_view";
+            /**
+             * The scope's own list predicate, in Lucene syntax, exactly as the caller passes it to
+             * `threads:search`. Required for `shared_inbox` and `saved_view`, rejected for
+             * `organization`. The server ANDs the read-state condition onto it and nothing else, which
+             * is what makes the count and the list agree. Until the predicate definition moves
+             * server-side, this is the caller's authored copy.
+             *
+             * example:
+             * _tags.keyword:inbox AND !_tags.keyword:trash
+             */
+            q?: string;
+            /**
+             * Shared inbox ids, resolved to bucket ids the same way `threads:search` resolves them.
+             */
+            inbox_id?: /* Shared inbox ids, resolved to bucket ids the same way `threads:search` resolves them. */ string | string[];
+        }
+        export interface UnreadCountsPayload {
+            /**
+             * Which read state to count against — the org's or the calling user's. Same meaning as
+             * `getUnread`'s path parameter, and unrelated to a scope's `type`.
+             *
+             */
+            actor: "organization" | "user";
+            /**
+             * Restrict every scope to messages involving these addresses.
+             */
+            email_filter?: string[];
+            scopes: [
+                UnreadCountScope,
+                UnreadCountScope?,
+                UnreadCountScope?,
+                UnreadCountScope?,
+                UnreadCountScope?,
+                UnreadCountScope?,
+                UnreadCountScope?,
+                UnreadCountScope?,
+                UnreadCountScope?,
+                UnreadCountScope?,
+                UnreadCountScope?,
+                UnreadCountScope?,
+                UnreadCountScope?,
+                UnreadCountScope?,
+                UnreadCountScope?,
+                UnreadCountScope?,
+                UnreadCountScope?,
+                UnreadCountScope?,
+                UnreadCountScope?,
+                UnreadCountScope?,
+                UnreadCountScope?,
+                UnreadCountScope?,
+                UnreadCountScope?,
+                UnreadCountScope?,
+                UnreadCountScope?
+            ];
+        }
+        export interface UnreadCountsResult {
+            /**
+             * False when the `message-unread-counts` flag is off for the calling org, in which case
+             * `counts` is empty and no Elasticsearch work was done. Callers render no badges rather
+             * than rendering zeroes.
+             *
+             * example:
+             * true
+             */
+            enabled: boolean;
+            /**
+             * One entry per scope, keyed by the scope's `name`. A scope whose predicate could not be
+             * built is **absent** rather than zero, because a zero badge is a claim about the mailbox
+             * and an absent one is a claim about the request.
+             *
+             */
+            counts: {
+                [name: string]: UnreadCountBuckets;
+            };
+            /**
+             * Names of scopes that were accepted but could not be counted — today, a shared inbox whose
+             * ids matched no bucket in this org. Listed explicitly so a caller can tell an omission apart
+             * from a mis-spelled scope name, both of which are otherwise just a missing key in `counts`.
+             *
+             */
+            omitted?: string[];
+        }
+        export interface WorkflowStartedEvent {
+            type: "WORKFLOW_STARTED";
+            /**
+             * ID of the workflow/flow execution that was started
+             */
+            workflow_id?: string;
+            /**
+             * Name of the workflow that was started
+             */
+            workflow_name?: string;
         }
-        export type TimelineEventData = ThreadDoneEvent | ThreadOpenEvent;
     }
 }
 declare namespace Paths {
@@ -1469,6 +1710,16 @@ declare namespace Paths {
             }
         }
     }
+    namespace GetUnreadCounts {
+        export type RequestBody = Components.Schemas.UnreadCountsPayload;
+        namespace Responses {
+            export type $200 = Components.Schemas.UnreadCountsResult;
+            export interface $400 {
+            }
+            export interface $403 {
+            }
+        }
+    }
     namespace MarkReadMessage {
         namespace Parameters {
             export type Id = string;
@@ -2973,6 +3224,35 @@ interface OperationMethods {
     data?: any,
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.GetUnread.Responses.$200>
+  /**
+   * getUnreadCounts - getUnreadCounts
+   * 
+   * Unread counts for several named scopes in one request.
+   * 
+   * A scope is a name plus the same parameters the thread list already takes (`q`, `inbox_id`),
+   * so a scope's count and the list beneath it are the same predicate and agree by construction.
+   * The server adds only the read-state condition; it does not re-author the caller's view.
+   * 
+   * The `organization` scope is the exception and takes no `q`: it reuses the four canonical
+   * central-inbox queries, so its numbers match `getUnread` exactly.
+   * 
+   * Buckets are not symmetric, across scope types or across actors. Every scope other than
+   * `organization` returns `unread` alone. The `organization` scope returns all four
+   * (`unread`, `drafts`, `unassigned`, `spam`) for `actor: organization`, and only `unread` and
+   * `drafts` for `actor: user` — the agent sidebar has no Spam or Unlinked folder, so those two
+   * numbers have nowhere to render and each one costs a cardinality aggregation. This is a
+   * deliberate divergence from `getUnread`, which computes all four for both actors.
+   * 
+   * Gated on the `message-unread-counts` flag, evaluated once per request against the calling
+   * org. With the flag off the response is `{ "enabled": false, "counts": {} }` and no
+   * Elasticsearch query is issued.
+   * 
+   */
+  'getUnreadCounts'(
+    parameters?: Parameters<UnknownParamsObject> | null,
+    data?: Paths.GetUnreadCounts.RequestBody,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.GetUnreadCounts.Responses.$200>
   /**
    * markUnreadMessageV2 - markUnreadMessageV2
    * 
@@ -3565,6 +3845,37 @@ interface PathsDictionary {
       config?: AxiosRequestConfig  
     ): OperationResponse<Paths.GetUnread.Responses.$200>
   }
+  ['/v1/message/unread:counts']: {
+    /**
+     * getUnreadCounts - getUnreadCounts
+     * 
+     * Unread counts for several named scopes in one request.
+     * 
+     * A scope is a name plus the same parameters the thread list already takes (`q`, `inbox_id`),
+     * so a scope's count and the list beneath it are the same predicate and agree by construction.
+     * The server adds only the read-state condition; it does not re-author the caller's view.
+     * 
+     * The `organization` scope is the exception and takes no `q`: it reuses the four canonical
+     * central-inbox queries, so its numbers match `getUnread` exactly.
+     * 
+     * Buckets are not symmetric, across scope types or across actors. Every scope other than
+     * `organization` returns `unread` alone. The `organization` scope returns all four
+     * (`unread`, `drafts`, `unassigned`, `spam`) for `actor: organization`, and only `unread` and
+     * `drafts` for `actor: user` — the agent sidebar has no Spam or Unlinked folder, so those two
+     * numbers have nowhere to render and each one costs a cardinality aggregation. This is a
+     * deliberate divergence from `getUnread`, which computes all four for both actors.
+     * 
+     * Gated on the `message-unread-counts` flag, evaluated once per request against the calling
+     * org. With the flag off the response is `{ "enabled": false, "counts": {} }` and no
+     * Elasticsearch query is issued.
+     * 
+     */
+    'post'(
+      parameters?: Parameters<UnknownParamsObject> | null,
+      data?: Paths.GetUnreadCounts.RequestBody,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.GetUnreadCounts.Responses.$200>
+  }
   ['/v2/message/messages/{id}/unread']: {
     /**
      * markUnreadMessageV2 - markUnreadMessageV2
@@ -4109,6 +4420,11 @@ type ErrorResponse = Components.Schemas.ErrorResponse;
 type FieldsParam = Components.Schemas.FieldsParam;
 type File = Components.Schemas.File;
 type Message = Components.Schemas.Message;
+type MessageAutoReplySentEvent = Components.Schemas.MessageAutoReplySentEvent;
+type MessageEntityLinkedEvent = Components.Schemas.MessageEntityLinkedEvent;
+type MessageEntityUnlinkedEvent = Components.Schemas.MessageEntityUnlinkedEvent;
+type MessageLabelAddedEvent = Components.Schemas.MessageLabelAddedEvent;
+type MessageLabelRemovedEvent = Components.Schemas.MessageLabelRemovedEvent;
 type MessageRequestParams = Components.Schemas.MessageRequestParams;
 type MessageV2 = Components.Schemas.MessageV2;
 type MoveThreadPayload = Components.Schemas.MoveThreadPayload;
@@ -4119,9 +4435,20 @@ type SearchParams = Components.Schemas.SearchParams;
 type SearchParamsV2 = Components.Schemas.SearchParamsV2;
 type Thread = Components.Schemas.Thread;
 type ThreadDoneEvent = Components.Schemas.ThreadDoneEvent;
+type ThreadMovedToInboxEvent = Components.Schemas.ThreadMovedToInboxEvent;
 type ThreadOpenEvent = Components.Schemas.ThreadOpenEvent;
+type ThreadRestoredEvent = Components.Schemas.ThreadRestoredEvent;
 type ThreadTimeline = Components.Schemas.ThreadTimeline;
+type ThreadTrashedEvent = Components.Schemas.ThreadTrashedEvent;
+type ThreadUserAssignedEvent = Components.Schemas.ThreadUserAssignedEvent;
+type TimelineActor = Components.Schemas.TimelineActor;
 type TimelineEvent = Components.Schemas.TimelineEvent;
 type TimelineEventData = Components.Schemas.TimelineEventData;
+type TimelineLinkedEntity = Components.Schemas.TimelineLinkedEntity;
+type UnreadCountBuckets = Components.Schemas.UnreadCountBuckets;
+type UnreadCountScope = Components.Schemas.UnreadCountScope;
+type UnreadCountsPayload = Components.Schemas.UnreadCountsPayload;
+type UnreadCountsResult = Components.Schemas.UnreadCountsResult;
+type WorkflowStartedEvent = Components.Schemas.WorkflowStartedEvent;
 
-export { type Address as A, type BaseEntity as B, type Client as C, type ErrorResponse as E, type FieldsParam as F, type Message as M, type OperationMethods as O, Paths as P, type ReadMessagePayload as R, type SearchIDParams as S, type Thread as T, Components as a, type PathsDictionary as b, type AssigneeWorkload as c, type AssigneeWorkloadParams as d, type AssigneeWorkloadResults as e, type AttachmentsRelation as f, type BulkActionsPayload as g, type BulkActionsPayloadWithScopes as h, type File as i, type MessageRequestParams as j, type MessageV2 as k, type MoveThreadPayload as l, type ReadingScope as m, type SearchParams as n, type SearchParamsV2 as o, type ThreadDoneEvent as p, type ThreadOpenEvent as q, type ThreadTimeline as r, type TimelineEvent as s, type TimelineEventData as t };
+export { type Address as A, type BaseEntity as B, type Client as C, type ThreadUserAssignedEvent as D, type ErrorResponse as E, type FieldsParam as F, type TimelineActor as G, type TimelineEvent as H, type TimelineEventData as I, type TimelineLinkedEntity as J, type UnreadCountScope as K, type UnreadCountsPayload as L, type Message as M, type UnreadCountsResult as N, type OperationMethods as O, Paths as P, type ReadMessagePayload as R, type SearchIDParams as S, type Thread as T, type UnreadCountBuckets as U, type WorkflowStartedEvent as W, Components as a, type PathsDictionary as b, type AssigneeWorkload as c, type AssigneeWorkloadParams as d, type AssigneeWorkloadResults as e, type AttachmentsRelation as f, type BulkActionsPayload as g, type BulkActionsPayloadWithScopes as h, type File as i, type MessageAutoReplySentEvent as j, type MessageEntityLinkedEvent as k, type MessageEntityUnlinkedEvent as l, type MessageLabelAddedEvent as m, type MessageLabelRemovedEvent as n, type MessageRequestParams as o, type MessageV2 as p, type MoveThreadPayload as q, type ReadingScope as r, type SearchParams as s, type SearchParamsV2 as t, type ThreadDoneEvent as u, type ThreadMovedToInboxEvent as v, type ThreadOpenEvent as w, type ThreadRestoredEvent as x, type ThreadTimeline as y, type ThreadTrashedEvent as z };

package/docs/calendar.md

@@ -901,7 +901,7 @@ const { data } = await client.getCalendar({
 
 ### `updateCalendar`
 
-Update fields on a calendar.
+Update local calendar details. Changes to synced calendars do not modify the provider calendar.
 
 `PATCH /v1/calendar/{calendar_id}`
 
@@ -950,7 +950,7 @@ const { data } = await client.updateCalendar(
 
 ### `deleteCalendar`
 
-Delete a native epilot calendar and its events.
+Delete a native epilot calendar or disconnect a synced calendar, including its locally stored events.
 
 `DELETE /v1/calendar/{calendar_id}`
 
@@ -1001,6 +1001,7 @@ const { data } = await client.listEvents({
       "status": "free",
       "busy": true,
       "is_cancelled": true,
+      "is_draft": true,
       "sensitivity": "normal",
       "importance": "low",
       "is_online_meeting": true,
@@ -1016,6 +1017,7 @@ const { data } = await client.listEvents({
           "type": "required"
         }
       ],
+      "metadata": {},
       "is_recurring": true,
       "series_master_id": "string",
       "source": {
@@ -1057,6 +1059,7 @@ const { data } = await client.createEvent(
     location: 'string',
     status: 'free',
     sensitivity: 'normal',
+    metadata: {},
     _title: 'string'
   },
 )
@@ -1083,6 +1086,7 @@ const { data } = await client.createEvent(
   "status": "free",
   "busy": true,
   "is_cancelled": true,
+  "is_draft": true,
   "sensitivity": "normal",
   "importance": "low",
   "is_online_meeting": true,
@@ -1098,6 +1102,7 @@ const { data } = await client.createEvent(
       "type": "required"
     }
   ],
+  "metadata": {},
   "is_recurring": true,
   "series_master_id": "string",
   "source": {
@@ -1150,6 +1155,7 @@ const { data } = await client.getEvent({
   "status": "free",
   "busy": true,
   "is_cancelled": true,
+  "is_draft": true,
   "sensitivity": "normal",
   "importance": "low",
   "is_online_meeting": true,
@@ -1165,6 +1171,7 @@ const { data } = await client.getEvent({
       "type": "required"
     }
   ],
+  "metadata": {},
   "is_recurring": true,
   "series_master_id": "string",
   "source": {
@@ -1203,6 +1210,7 @@ const { data } = await client.updateEvent(
     is_all_day: true,
     location: 'string',
     status: 'free',
+    is_cancelled: true,
     sensitivity: 'normal',
     _title: 'string'
   },
@@ -1230,6 +1238,7 @@ const { data } = await client.updateEvent(
   "status": "free",
   "busy": true,
   "is_cancelled": true,
+  "is_draft": true,
   "sensitivity": "normal",
   "importance": "low",
   "is_online_meeting": true,
@@ -1245,6 +1254,7 @@ const { data } = await client.updateEvent(
       "type": "required"
     }
   ],
+  "metadata": {},
   "is_recurring": true,
   "series_master_id": "string",
   "source": {
@@ -1633,6 +1643,7 @@ type CalendarEvent = {
   status: "free" | "tentative" | "busy" | "oof" | "workingElsewhere" | "unknown"
   busy: boolean
   is_cancelled: boolean
+  is_draft: boolean
   sensitivity: "normal" | "personal" | "private" | "confidential"
   importance: "low" | "normal" | "high"
   is_online_meeting: boolean
@@ -1646,6 +1657,7 @@ type CalendarEvent = {
     response: "none" | "organizer" | "tentativelyAccepted" | "accepted" | "declined" | "notResponded"
     type: "required" | "optional" | "resource"
   }>
+  metadata?: Record<string, unknown>
   is_recurring: boolean
   series_master_id?: string
   source: {
@@ -1732,6 +1744,7 @@ type CalendarEventCreateBody = {
   location?: string
   status: "free" | "tentative" | "busy" | "oof" | "workingElsewhere" | "unknown"
   sensitivity: "normal" | "personal" | "private" | "confidential"
+  metadata?: Record<string, unknown>
   _title: string
 }
 ```
@@ -1747,6 +1760,7 @@ type CalendarEventPatchBody = {
   is_all_day?: boolean
   location?: string
   status?: "free" | "tentative" | "busy" | "oof" | "workingElsewhere" | "unknown"
+  is_cancelled?: boolean
   sensitivity?: "normal" | "personal" | "private" | "confidential"
   _title?: string
 }