@fourier-labs/harbour-contracts 0.85.0 → 0.86.0

package/dist/gen-ts/integration-execute-result.d.ts

@@ -1,5 +1,5 @@
 /**
- * The `data` member of a successful execute response `{data, requestId}`; the SDK unwraps `data`. Exactly one of the operation results (thirty-three operations since 0.78.0, ADR 0018, ADR 0022 and ADR 0024): slack.channel.history -> {messages, hasMore, nextCursor?} (plain text/IDs/time, plus the display name and emoji icon a per-app-named app post carries — authorName/authorIcon, 0.55.0 — never the provider payload; `nextCursor` when hasMore, to pass as the next read's `cursor`); slack.message.post, slack.message.update, slack.message.delete -> {messageId} (the Slack ts); slack.dm.send -> {messageId, channelId} (the ts and the DM channel it went to); slack.user.lookup -> {userId, displayName}; gmail.thread.list -> {threads, hasMore, nextPageToken?} (newest matching threads; each `messageId` is the thread's newest message, what gmail.message.read takes; `nextPageToken` when hasMore); gmail.thread.read -> {id, emails} (every message of the thread, oldest first, each shaped like a gmail.message.read result); gmail.message.read -> {id, threadId, subject, from, to, date, text, truncated, attachments?} (headers plus the plain text with html stripped, cut at 16 KiB with `truncated` set; `attachments` lists the files without their bytes, which gmail.attachment.read fetches by id); gmail.attachment.read -> {filename, mimeType, size, dataBase64}; gmail.message.send -> {messageId, threadId} (the Gmail ids of the sent message and its thread); warehouse.view.read -> {rows, truncated} (rows keyed by the selected columns, or for an aggregate read by the groupBy columns then the aggregate aliases; decimal/64-bit values as strings, dates as ISO strings; since 0.70.0 every server sends `truncated`, true when more rows matched than `limit` — the server reads limit+1 rows to know — so the rows are incomplete and must not be totalled or averaged; a server before 0.70.0 omitted it). Basecamp (0.76.0, ADR 0022; every id a string of digits, every page at most 100 items, `nextPageToken` only when hasMore, text cut at 16 KiB like Gmail): basecamp.project.list -> {projects, hasMore, nextPageToken?}; basecamp.todolist.list -> {todolists, hasMore, nextPageToken?}; basecamp.todo.list -> {todos, hasMore, nextPageToken?}; basecamp.message.list -> {boardMessages, hasMore, nextPageToken?} (`boardMessages`, not `messages`, which is the Slack history shape); basecamp.comment.list -> {comments, hasMore, nextPageToken?}; basecamp.people.list -> {people, hasMore, nextPageToken?}; basecamp.todo.create, basecamp.message.post, basecamp.comment.post, basecamp.campfire.post -> {id, appUrl} (the new recording and its Basecamp page); basecamp.todo.complete -> {id, completed} with completed always true. SharePoint (0.78.0, ADR 0024; every id a Microsoft Graph id, `nextPageToken` only when hasMore and up to 2048 characters for a Graph `$skiptoken`): sharepoint.list.list -> {lists, hasMore, nextPageToken?} (at most 100, hidden lists dropped); sharepoint.item.list -> {items, hasMore, nextPageToken?} (at most 50; each item's `fields` are the column values as Graph returns them with the system columns dropped, the whole object cut at 16 KiB); sharepoint.drive.list -> {drives, hasMore, nextPageToken?}; sharepoint.file.list and sharepoint.file.search -> {files, hasMore, nextPageToken?} (at most 100 entries, folders included with isFolder); sharepoint.file.read -> {id, filename, mimeType, size, dataBase64} (the Gmail attachment shape plus the file's id; at most 2 MiB of bytes); sharepoint.item.create -> {id, webUrl} (the new item and its SharePoint page); sharepoint.item.update -> {id}; sharepoint.file.upload -> {id, filename, webUrl} (the stored file, under the name `conflict` rename may have given it). An unknown send outcome is never a result; it is an error with details.code SEND_OUTCOME_UNKNOWN. A whole result over 1 MiB is rejected, never cut down to fit — except a gmail.attachment.read or a sharepoint.file.read, whose single file is bounded by its own 2 MiB.
+ * The `data` member of a successful execute response `{data, requestId}`; the SDK unwraps `data`. Exactly one of the operation results (eighty-one operations since 0.86.0, ADR 0018, ADR 0022, ADR 0024, ADR 0028, ADR 0029 and ADR 0032): slack.channel.history -> {messages, hasMore, nextCursor?} (plain text/IDs/time, plus the display name and emoji icon a per-app-named app post carries — authorName/authorIcon, 0.55.0 — never the provider payload; `nextCursor` when hasMore, to pass as the next read's `cursor`); slack.message.post, slack.message.update, slack.message.delete -> {messageId} (the Slack ts); slack.dm.send -> {messageId, channelId} (the ts and the DM channel it went to); slack.user.lookup -> {userId, displayName}; gmail.thread.list -> {threads, hasMore, nextPageToken?} (newest matching threads; each `messageId` is the thread's newest message, what gmail.message.read takes; `nextPageToken` when hasMore); gmail.thread.read -> {id, emails} (every message of the thread, oldest first, each shaped like a gmail.message.read result); gmail.message.read -> {id, threadId, subject, from, to, date, text, truncated, attachments?} (headers plus the plain text with html stripped, cut at 16 KiB with `truncated` set; `attachments` lists the files without their bytes, which gmail.attachment.read fetches by id); gmail.attachment.read -> {filename, mimeType, size, dataBase64}; gmail.message.send -> {messageId, threadId} (the Gmail ids of the sent message and its thread); warehouse.view.read -> {rows, truncated} (rows keyed by the selected columns, or for an aggregate read by the groupBy columns then the aggregate aliases; decimal/64-bit values as strings, dates as ISO strings; since 0.70.0 every server sends `truncated`, true when more rows matched than `limit` — the server reads limit+1 rows to know — so the rows are incomplete and must not be totalled or averaged; a server before 0.70.0 omitted it). Basecamp (0.76.0, ADR 0022; every id a string of digits, every page at most 100 items, `nextPageToken` only when hasMore, text cut at 16 KiB like Gmail): basecamp.project.list -> {projects, hasMore, nextPageToken?}; basecamp.todolist.list -> {todolists, hasMore, nextPageToken?}; basecamp.todo.list -> {todos, hasMore, nextPageToken?}; basecamp.message.list -> {boardMessages, hasMore, nextPageToken?} (`boardMessages`, not `messages`, which is the Slack history shape); basecamp.comment.list -> {comments, hasMore, nextPageToken?}; basecamp.people.list -> {people, hasMore, nextPageToken?}; basecamp.todo.create, basecamp.message.post, basecamp.comment.post, basecamp.campfire.post -> {id, appUrl} (the new recording and its Basecamp page); basecamp.todo.complete -> {id, completed} with completed always true. SharePoint (0.78.0, ADR 0024; every id a Microsoft Graph id, `nextPageToken` only when hasMore and up to 2048 characters for a Graph `$skiptoken`): sharepoint.list.list -> {lists, hasMore, nextPageToken?} (at most 100, hidden lists dropped); sharepoint.item.list -> {items, hasMore, nextPageToken?} (at most 50; each item's `fields` are the column values as Graph returns them with the system columns dropped, the whole object cut at 16 KiB); sharepoint.drive.list -> {drives, hasMore, nextPageToken?}; sharepoint.file.list and sharepoint.file.search -> {files, hasMore, nextPageToken?} (at most 100 entries, folders included with isFolder); sharepoint.file.read -> {id, filename, mimeType, size, dataBase64} (the Gmail attachment shape plus the file's id; at most 2 MiB of bytes); sharepoint.item.create -> {id, webUrl} (the new item and its SharePoint page); sharepoint.item.update -> {id}; sharepoint.file.upload -> {id, filename, webUrl} (the stored file, under the name `conflict` rename may have given it). Google Workspace and Microsoft 365 (0.86.0, ADR 0032; every page at most 100 items, `nextPageToken` only when hasMore, up to 2048 characters): calendar.calendar.list -> {calendars, hasMore, nextPageToken?}; calendar.event.list and outlook.event.list -> {events, hasMore, nextPageToken?}; calendar.event.read and outlook.event.read -> the event itself, {id, title, start, end, allDay, timeZone?, location?, description?, attendees, organizer?, webUrl, eventStatus} (the CalendarEvent shape spread at the top level, the way gmail.message.read spreads GmailMessage; `eventStatus`, because `status` is the HTTP status of a service.request result); calendar.event.create and outlook.event.create -> {id, webUrl}; calendar.event.update, calendar.event.cancel, outlook.event.update, outlook.event.cancel -> {id}; drive.file.list, drive.file.search, onedrive.file.list, onedrive.file.search -> {files, hasMore, nextPageToken?} (the SharePoint entry shape); drive.file.read and onedrive.file.read -> {id, filename, mimeType, size, dataBase64} (the sharepoint.file.read shape; `filename` and `mimeType` are the stored or exported name and type); drive.file.upload and onedrive.file.upload -> {id, filename, webUrl}; drive.folder.create and onedrive.folder.create -> {id, webUrl}; docs.document.read -> {id, title, text, revisionId, webUrl, truncated} (the body as plain text cut at 64 KiB); docs.document.create -> {id, webUrl}; docs.document.append -> {id, revisionId}; docs.text.replace -> {id, replaced} (how many occurrences changed); sheets.spreadsheet.read -> {id, title, sheets, webUrl}; sheets.values.read -> {range, values} (the range Google answered with and the cells as rows; a trailing empty row or cell is dropped by Google); sheets.values.append -> {range, updatedRows}; sheets.values.update -> {range, updatedCells}; sheets.values.clear -> {range}; sheets.spreadsheet.create -> {id, webUrl}; outlook.message.list -> {mailMessages, hasMore, nextPageToken?} (`mailMessages`, not `messages`, which is the Slack history shape); outlook.message.read -> the gmail.message.read shape {id, threadId, subject, from, to, date, text, truncated, attachments?} with `threadId` the Graph conversationId; outlook.attachment.read -> {id, filename, mimeType, size, dataBase64}; outlook.message.send and outlook.message.reply -> {id} (the sent message's id, which Graph does not return for a send: governance's own internetMessageId); excel.worksheet.list -> {worksheets}; excel.range.read -> {address, values}; excel.range.update -> {address, updatedCells}; excel.table.list -> {tables}; excel.row.add -> {index, updatedRows} (the index of the first added row); excel.worksheet.add -> {id, name}; teams.message.list -> {teamsMessages, hasMore, nextPageToken?} (`teamsMessages`, apart from Slack's `messages`); teams.message.post and teams.reply.post -> {id, webUrl}. An unknown send outcome is never a result; it is an error with details.code SEND_OUTCOME_UNKNOWN. A whole result over 1 MiB is rejected, never cut down to fit — except a gmail.attachment.read, a sharepoint.file.read, a drive.file.read, an onedrive.file.read or an outlook.attachment.read, whose single file is bounded by its own 2 MiB.
  */
 export type IntegrationExecuteResult = {
     /**
@@ -29,21 +29,27 @@ export type IntegrationExecuteResult = {
      */
     threads?: GmailThread[];
     /**
-     * gmail.thread.list (0.71.0), the basecamp.* lists (0.76.0) and the paged sharepoint.* reads (0.78.0): the token of the next page, present only when hasMore; up to 2048 characters since 0.78.0 for a Graph $skiptoken.
+     * gmail.thread.list (0.71.0), the basecamp.* lists (0.76.0) and the paged sharepoint.* reads (0.78.0): the token of the next page, present only when hasMore; up to 2048 characters since 0.78.0 for a Graph $skiptoken. The paged 0.86.0 reads (calendars, events, files, mailMessages, teamsMessages) page the same way.
      */
     nextPageToken?: string;
     /**
-     * gmail.thread.read / gmail.message.read: the Gmail id; the Basecamp writes and complete (0.76.0): the recording's id; the SharePoint writes and sharepoint.file.read (0.78.0): the Graph id of the item or file (up to 256 characters since 0.78.0, the GraphId bound).
+     * gmail.thread.read / gmail.message.read: the Gmail id; the Basecamp writes and complete (0.76.0): the recording's id; the SharePoint writes and sharepoint.file.read (0.78.0): the Graph id of the item or file (up to 256 characters since 0.78.0, the GraphId bound). The Google Workspace and Microsoft 365 operations (0.86.0): the event, file, folder, document, spreadsheet, message or worksheet id (up to 1024 characters since 0.86.0, a Google event id's bound).
      */
     id?: string;
+    /**
+     * gmail.message.read / gmail.message.send: the Gmail thread id. outlook.message.read (0.86.0): the Graph conversationId (up to 256 characters since 0.86.0).
+     */
     threadId?: string;
     subject?: string;
     from?: string;
     to?: string;
     date?: string;
+    /**
+     * gmail.message.read and outlook.message.read (0.86.0): the plain-text body, cut at 16 KiB with `truncated` set. docs.document.read (0.86.0): the document's body as plain text, cut at 64 KiB (the shared bound).
+     */
     text?: string;
     /**
-     * gmail.message.read: the text was cut at 16 KiB. warehouse.view.read (0.70.0): more rows matched than the read's limit, so `rows` is incomplete.
+     * gmail.message.read: the text was cut at 16 KiB. warehouse.view.read (0.70.0): more rows matched than the read's limit, so `rows` is incomplete. docs.document.read (0.86.0): the text was cut at 64 KiB.
      */
     truncated?: boolean;
     /**
@@ -62,7 +68,13 @@ export type IntegrationExecuteResult = {
      * @maxItems 100
      */
     emails?: GmailMessage[];
+    /**
+     * gmail.attachment.read / sharepoint.file.read / sharepoint.file.upload: the file's name. drive.file.read / onedrive.file.read / outlook.attachment.read (0.86.0): the stored name, or for an exported Google file the name with the export's extension. drive.file.upload / onedrive.file.upload: the stored name, which `conflict` rename may have changed.
+     */
     filename?: string;
+    /**
+     * gmail.attachment.read / sharepoint.file.read / outlook.attachment.read (0.86.0): the file's MIME type. drive.file.read / onedrive.file.read (0.86.0): the stored type, or the export's (text/plain, text/csv, application/pdf).
+     */
     mimeType?: string;
     /**
      * gmail.attachment.read (0.71.0): the attachment's size in bytes.
@@ -141,21 +153,144 @@ export type IntegrationExecuteResult = {
      */
     drives?: SharePointDrive[];
     /**
-     * sharepoint.file.list / sharepoint.file.search (0.78.0): one page of a folder's entries (files and folders) or of the files matching the search.
+     * sharepoint.file.list / sharepoint.file.search (0.78.0): one page of a folder's entries (files and folders) or of the files matching the search. drive.file.list / drive.file.search / onedrive.file.list / onedrive.file.search (0.86.0): the same shape for a Google Drive folder or search and for a OneDrive one.
      *
      * @maxItems 100
      */
     files?: SharePointFile[];
     /**
-     * sharepoint.item.create / sharepoint.file.upload (0.78.0): the SharePoint page of the new item or file, for a person to open.
+     * sharepoint.item.create / sharepoint.file.upload (0.78.0): the SharePoint page of the new item or file, for a person to open. The Google Workspace and Microsoft 365 writes (0.86.0): the page of the new event, file, folder, document, spreadsheet or message, for a person to open.
      */
     webUrl?: string;
+    /**
+     * calendar.calendar.list (0.86.0): one page of the calendars the signed-in person can see; `id` is what the calendar.event.* operations take as `calendarId`.
+     *
+     * @maxItems 100
+     */
+    calendars?: CalendarListEntry[];
+    /**
+     * calendar.event.list / outlook.event.list (0.86.0): one page of the events in the window, recurring events expanded to instances, ordered by start.
+     *
+     * @maxItems 100
+     */
+    events?: CalendarEvent[];
+    /**
+     * calendar.event.read / outlook.event.read (0.86.0): the event's title. docs.document.read: the document's title. sheets.spreadsheet.read: the spreadsheet's title.
+     */
+    title?: string;
+    /**
+     * calendar.event.read / outlook.event.read (0.86.0): when the event starts, an RFC 3339 date-time, or a YYYY-MM-DD date for an all-day event.
+     */
+    start?: string;
+    /**
+     * calendar.event.read / outlook.event.read (0.86.0): when the event ends, the same way (the day after the last day for an all-day event).
+     */
+    end?: string;
+    /**
+     * calendar.event.read / outlook.event.read (0.86.0): whether the event spans whole days.
+     */
+    allDay?: boolean;
+    /**
+     * calendar.event.read / outlook.event.read (0.86.0): the IANA zone the event is shown in, when the provider reports one.
+     */
+    timeZone?: string;
+    /**
+     * calendar.event.read / outlook.event.read (0.86.0): where the event is, as free text, when set.
+     */
+    location?: string;
+    /**
+     * calendar.event.read / outlook.event.read (0.86.0): the event's description as plain text, cut at 16 KiB, when set.
+     */
+    description?: string;
+    /**
+     * calendar.event.read / outlook.event.read (0.86.0): who is invited and how they answered; empty when the event has no attendees.
+     *
+     * @maxItems 500
+     */
+    attendees?: CalendarAttendee[];
+    organizer?: CalendarAttendee1;
+    /**
+     * An event's state (0.86.0): confirmed (Google `confirmed`, Graph not cancelled and not tentative), tentative, or cancelled.
+     */
+    eventStatus?: 'confirmed' | 'tentative' | 'cancelled';
+    /**
+     * docs.document.read / docs.document.append (0.86.0): the document's revision after the read or the append, as Google names it.
+     */
+    revisionId?: string;
+    /**
+     * docs.text.replace (0.86.0): how many occurrences were replaced over all the pairs.
+     */
+    replaced?: number;
+    /**
+     * sheets.spreadsheet.read (0.86.0): the spreadsheet's sheets in tab order, with their grid sizes.
+     *
+     * @maxItems 200
+     */
+    sheets?: SheetProperties[];
+    /**
+     * sheets.values.read / sheets.values.append / sheets.values.update / sheets.values.clear (0.86.0): the range Google answered with in A1 notation (for an append, the cells the rows went into).
+     */
+    range?: string;
+    /**
+     * sheets.values.read / excel.range.read (0.86.0): the cells as rows, each cell a string, a number, a boolean or null (an empty cell); unformatted values (a date cell is its serial number at Google, its text at Excel). The whole object is cut at 1 MiB by the result cap, never trimmed.
+     *
+     * @maxItems 1000
+     */
+    values?: (string | number | boolean | null)[][];
+    /**
+     * sheets.values.append / excel.row.add (0.86.0): how many rows were written.
+     */
+    updatedRows?: number;
+    /**
+     * sheets.values.update / excel.range.update (0.86.0): how many cells were written.
+     */
+    updatedCells?: number;
+    /**
+     * excel.worksheet.list (0.86.0): the workbook's worksheets in tab order.
+     *
+     * @maxItems 500
+     */
+    worksheets?: ExcelWorksheet[];
+    /**
+     * excel.range.read / excel.range.update (0.86.0): the range Excel answered with, e.g. `Orders!A1:D10`.
+     */
+    address?: string;
+    /**
+     * excel.table.list (0.86.0): the workbook's or the worksheet's tables; `name` is what excel.row.add takes as `tableName`.
+     *
+     * @maxItems 500
+     */
+    tables?: ExcelTable[];
+    /**
+     * excel.row.add (0.86.0): the zero-based index, within the table, of the first row added.
+     */
+    index?: number;
+    /**
+     * excel.worksheet.add (0.86.0): the new worksheet's name.
+     */
+    name?: string;
+    /**
+     * outlook.message.list (0.86.0): one page of the folder's messages, newest first (or by relevance for a search), without their bodies; `id` is what outlook.message.read takes. Named apart from `messages`, the Slack history shape, and `emails`, the Gmail thread shape.
+     *
+     * @maxItems 100
+     */
+    mailMessages?: OutlookMessageSummary[];
+    /**
+     * teams.message.list (0.86.0): one page of the channel's top-level messages, newest first; `id` is what teams.reply.post takes as `messageId`. Named apart from `messages`, the Slack history shape.
+     *
+     * @maxItems 100
+     */
+    teamsMessages?: TeamsMessage[];
     status?: number;
     headers?: {
         [k: string]: string;
     };
     body?: unknown;
 };
+/**
+ * An event's state (0.86.0): confirmed (Google `confirmed`, Graph not cancelled and not tentative), tentative, or cancelled.
+ */
+export type CalendarEventStatus = 'confirmed' | 'tentative' | 'cancelled';
 export interface ChannelMessage {
     id: string;
     text: string;
@@ -366,7 +501,7 @@ export interface SharePointDrive {
     webUrl: string;
 }
 /**
- * One entry of a sharepoint.file.list or sharepoint.file.search result (0.78.0): a file (`mimeType` set, `id` is what sharepoint.file.read takes as `fileId`) or a folder (`isFolder`, `id` is what sharepoint.file.list and sharepoint.file.upload take as `folderId`). `size` is in bytes; a folder's is the total of its contents.
+ * One entry of a sharepoint.file.list or sharepoint.file.search result (0.78.0): a file (`mimeType` set, `id` is what sharepoint.file.read takes as `fileId`) or a folder (`isFolder`, `id` is what sharepoint.file.list and sharepoint.file.upload take as `folderId`). `size` is in bytes; a folder's is the total of its contents. drive.file.list / drive.file.search / onedrive.file.list / onedrive.file.search (0.86.0) answer the same entries: for Google Drive `mimeType` is the Drive type (a Google Docs file is application/vnd.google-apps.document) and `size` 0 for a Google-native file; `id` is what drive.file.read / onedrive.file.read take as `fileId`, a folder's what file.list, file.upload and folder.create take as `folderId`.
  */
 export interface SharePointFile {
     /**
@@ -380,3 +515,98 @@ export interface SharePointFile {
     webUrl: string;
     modifiedAt: string;
 }
+/**
+ * One calendar of a calendar.calendar.list result (0.86.0); `id` is what the calendar.event.* operations take as `calendarId`, `primary` marks the person's own calendar, `accessRole` is Google's (owner, writer, reader, freeBusyReader).
+ */
+export interface CalendarListEntry {
+    id: string;
+    name: string;
+    primary: boolean;
+    accessRole: string;
+}
+/**
+ * One event of a calendar.event.list or outlook.event.list result (0.86.0), and the shape calendar.event.read and outlook.event.read spread at the top level. `start` and `end` are RFC 3339 date-times, or YYYY-MM-DD dates when `allDay`; `description` is plain text cut at 16 KiB; `id` is what the event.read, event.update and event.cancel operations take as `eventId`.
+ */
+export interface CalendarEvent {
+    id: string;
+    title: string;
+    start: string;
+    end: string;
+    allDay: boolean;
+    timeZone?: string;
+    location?: string;
+    description?: string;
+    /**
+     * @maxItems 500
+     */
+    attendees: CalendarAttendee[];
+    organizer?: CalendarAttendee;
+    webUrl: string;
+    eventStatus: CalendarEventStatus;
+}
+/**
+ * A person on an event (0.86.0): an attendee or the organizer. `response` is theirs when the provider reports it: accepted, declined, tentative or needsAction.
+ */
+export interface CalendarAttendee {
+    email: string;
+    name?: string;
+    response?: 'accepted' | 'declined' | 'tentative' | 'needsAction';
+}
+/**
+ * A person on an event (0.86.0): an attendee or the organizer. `response` is theirs when the provider reports it: accepted, declined, tentative or needsAction.
+ */
+export interface CalendarAttendee1 {
+    email: string;
+    name?: string;
+    response?: 'accepted' | 'declined' | 'tentative' | 'needsAction';
+}
+/**
+ * One sheet (tab) of a sheets.spreadsheet.read result (0.86.0): Google's numeric sheetId, its title (what a `range` names before the `!`) and its grid size.
+ */
+export interface SheetProperties {
+    id: number;
+    title: string;
+    rows: number;
+    columns: number;
+}
+/**
+ * One worksheet of an excel.worksheet.list result (0.86.0); `name` or `id` is what excel.range.read, excel.range.update and excel.table.list take as `worksheet`; `position` is its zero-based tab index.
+ */
+export interface ExcelWorksheet {
+    id: string;
+    name: string;
+    position: number;
+}
+/**
+ * One table of an excel.table.list result (0.86.0); `name` is what excel.row.add takes as `tableName`, `worksheet` the name of the sheet it lives on.
+ */
+export interface ExcelTable {
+    id: string;
+    name: string;
+    worksheet: string;
+}
+/**
+ * One message of an outlook.message.list result (0.86.0), without its body: `preview` is Graph's bodyPreview (at most 255 characters), `from` and `to` are addresses as text; `id` is what outlook.message.read, outlook.attachment.read and outlook.message.reply take as `messageId`.
+ */
+export interface OutlookMessageSummary {
+    id: string;
+    conversationId: string;
+    subject: string;
+    from: string;
+    to: string;
+    receivedAt: string;
+    preview: string;
+    hasAttachments: boolean;
+    webUrl: string;
+}
+/**
+ * One top-level message of a teams.message.list result (0.86.0): `from` is the sender's display name (or the app's), `text` the body as plain text with HTML stripped, cut at 16 KiB, `replyCount` how many replies it has when Graph reports it; `id` is what teams.reply.post takes as `messageId`.
+ */
+export interface TeamsMessage {
+    id: string;
+    from: string;
+    text: string;
+    createdAt: string;
+    webUrl: string;
+    replyCount?: number;
+}

package/dist/gen-ts/integration-operations.d.ts

@@ -231,6 +231,321 @@ export declare const IntegrationOperations: {
         readonly declaredMode: false;
         readonly idempotencyKey: false;
     };
+    readonly "calendar.calendar.list": {
+        readonly kind: "saas";
+        readonly identities: readonly ["user"];
+        readonly readOnly: true;
+        readonly declaredMode: false;
+        readonly idempotencyKey: false;
+    };
+    readonly "calendar.event.list": {
+        readonly kind: "saas";
+        readonly identities: readonly ["user"];
+        readonly readOnly: true;
+        readonly declaredMode: false;
+        readonly idempotencyKey: false;
+    };
+    readonly "calendar.event.read": {
+        readonly kind: "saas";
+        readonly identities: readonly ["user"];
+        readonly readOnly: true;
+        readonly declaredMode: false;
+        readonly idempotencyKey: false;
+    };
+    readonly "calendar.event.create": {
+        readonly kind: "saas";
+        readonly identities: readonly ["user"];
+        readonly readOnly: false;
+        readonly declaredMode: false;
+        readonly idempotencyKey: true;
+    };
+    readonly "calendar.event.update": {
+        readonly kind: "saas";
+        readonly identities: readonly ["user"];
+        readonly readOnly: false;
+        readonly declaredMode: false;
+        readonly idempotencyKey: false;
+    };
+    readonly "calendar.event.cancel": {
+        readonly kind: "saas";
+        readonly identities: readonly ["user"];
+        readonly readOnly: false;
+        readonly declaredMode: false;
+        readonly idempotencyKey: false;
+    };
+    readonly "drive.file.list": {
+        readonly kind: "saas";
+        readonly identities: readonly ["user"];
+        readonly readOnly: true;
+        readonly declaredMode: false;
+        readonly idempotencyKey: false;
+    };
+    readonly "drive.file.search": {
+        readonly kind: "saas";
+        readonly identities: readonly ["user"];
+        readonly readOnly: true;
+        readonly declaredMode: false;
+        readonly idempotencyKey: false;
+    };
+    readonly "drive.file.read": {
+        readonly kind: "saas";
+        readonly identities: readonly ["user"];
+        readonly readOnly: true;
+        readonly declaredMode: false;
+        readonly idempotencyKey: false;
+    };
+    readonly "drive.file.upload": {
+        readonly kind: "saas";
+        readonly identities: readonly ["user"];
+        readonly readOnly: false;
+        readonly declaredMode: false;
+        readonly idempotencyKey: true;
+    };
+    readonly "drive.folder.create": {
+        readonly kind: "saas";
+        readonly identities: readonly ["user"];
+        readonly readOnly: false;
+        readonly declaredMode: false;
+        readonly idempotencyKey: true;
+    };
+    readonly "docs.document.read": {
+        readonly kind: "saas";
+        readonly identities: readonly ["user"];
+        readonly readOnly: true;
+        readonly declaredMode: false;
+        readonly idempotencyKey: false;
+    };
+    readonly "docs.document.create": {
+        readonly kind: "saas";
+        readonly identities: readonly ["user"];
+        readonly readOnly: false;
+        readonly declaredMode: false;
+        readonly idempotencyKey: true;
+    };
+    readonly "docs.document.append": {
+        readonly kind: "saas";
+        readonly identities: readonly ["user"];
+        readonly readOnly: false;
+        readonly declaredMode: false;
+        readonly idempotencyKey: false;
+    };
+    readonly "docs.text.replace": {
+        readonly kind: "saas";
+        readonly identities: readonly ["user"];
+        readonly readOnly: false;
+        readonly declaredMode: false;
+        readonly idempotencyKey: false;
+    };
+    readonly "sheets.spreadsheet.read": {
+        readonly kind: "saas";
+        readonly identities: readonly ["user"];
+        readonly readOnly: true;
+        readonly declaredMode: false;
+        readonly idempotencyKey: false;
+    };
+    readonly "sheets.values.read": {
+        readonly kind: "saas";
+        readonly identities: readonly ["user"];
+        readonly readOnly: true;
+        readonly declaredMode: false;
+        readonly idempotencyKey: false;
+    };
+    readonly "sheets.values.append": {
+        readonly kind: "saas";
+        readonly identities: readonly ["user"];
+        readonly readOnly: false;
+        readonly declaredMode: false;
+        readonly idempotencyKey: true;
+    };
+    readonly "sheets.values.update": {
+        readonly kind: "saas";
+        readonly identities: readonly ["user"];
+        readonly readOnly: false;
+        readonly declaredMode: false;
+        readonly idempotencyKey: false;
+    };
+    readonly "sheets.values.clear": {
+        readonly kind: "saas";
+        readonly identities: readonly ["user"];
+        readonly readOnly: false;
+        readonly declaredMode: false;
+        readonly idempotencyKey: false;
+    };
+    readonly "sheets.spreadsheet.create": {
+        readonly kind: "saas";
+        readonly identities: readonly ["user"];
+        readonly readOnly: false;
+        readonly declaredMode: false;
+        readonly idempotencyKey: true;
+    };
+    readonly "outlook.message.list": {
+        readonly kind: "saas";
+        readonly identities: readonly ["user"];
+        readonly readOnly: true;
+        readonly declaredMode: false;
+        readonly idempotencyKey: false;
+    };
+    readonly "outlook.message.read": {
+        readonly kind: "saas";
+        readonly identities: readonly ["user"];
+        readonly readOnly: true;
+        readonly declaredMode: false;
+        readonly idempotencyKey: false;
+    };
+    readonly "outlook.attachment.read": {
+        readonly kind: "saas";
+        readonly identities: readonly ["user"];
+        readonly readOnly: true;
+        readonly declaredMode: false;
+        readonly idempotencyKey: false;
+    };
+    readonly "outlook.message.send": {
+        readonly kind: "saas";
+        readonly identities: readonly ["user"];
+        readonly readOnly: false;
+        readonly declaredMode: false;
+        readonly idempotencyKey: true;
+    };
+    readonly "outlook.message.reply": {
+        readonly kind: "saas";
+        readonly identities: readonly ["user"];
+        readonly readOnly: false;
+        readonly declaredMode: false;
+        readonly idempotencyKey: true;
+    };
+    readonly "outlook.event.list": {
+        readonly kind: "saas";
+        readonly identities: readonly ["user"];
+        readonly readOnly: true;
+        readonly declaredMode: false;
+        readonly idempotencyKey: false;
+    };
+    readonly "outlook.event.read": {
+        readonly kind: "saas";
+        readonly identities: readonly ["user"];
+        readonly readOnly: true;
+        readonly declaredMode: false;
+        readonly idempotencyKey: false;
+    };
+    readonly "outlook.event.create": {
+        readonly kind: "saas";
+        readonly identities: readonly ["user"];
+        readonly readOnly: false;
+        readonly declaredMode: false;
+        readonly idempotencyKey: true;
+    };
+    readonly "outlook.event.update": {
+        readonly kind: "saas";
+        readonly identities: readonly ["user"];
+        readonly readOnly: false;
+        readonly declaredMode: false;
+        readonly idempotencyKey: false;
+    };
+    readonly "outlook.event.cancel": {
+        readonly kind: "saas";
+        readonly identities: readonly ["user"];
+        readonly readOnly: false;
+        readonly declaredMode: false;
+        readonly idempotencyKey: false;
+    };
+    readonly "onedrive.file.list": {
+        readonly kind: "saas";
+        readonly identities: readonly ["user"];
+        readonly readOnly: true;
+        readonly declaredMode: false;
+        readonly idempotencyKey: false;
+    };
+    readonly "onedrive.file.search": {
+        readonly kind: "saas";
+        readonly identities: readonly ["user"];
+        readonly readOnly: true;
+        readonly declaredMode: false;
+        readonly idempotencyKey: false;
+    };
+    readonly "onedrive.file.read": {
+        readonly kind: "saas";
+        readonly identities: readonly ["user"];
+        readonly readOnly: true;
+        readonly declaredMode: false;
+        readonly idempotencyKey: false;
+    };
+    readonly "onedrive.file.upload": {
+        readonly kind: "saas";
+        readonly identities: readonly ["user"];
+        readonly readOnly: false;
+        readonly declaredMode: false;
+        readonly idempotencyKey: true;
+    };
+    readonly "onedrive.folder.create": {
+        readonly kind: "saas";
+        readonly identities: readonly ["user"];
+        readonly readOnly: false;
+        readonly declaredMode: false;
+        readonly idempotencyKey: true;
+    };
+    readonly "excel.worksheet.list": {
+        readonly kind: "saas";
+        readonly identities: readonly ["user"];
+        readonly readOnly: true;
+        readonly declaredMode: false;
+        readonly idempotencyKey: false;
+    };
+    readonly "excel.range.read": {
+        readonly kind: "saas";
+        readonly identities: readonly ["user"];
+        readonly readOnly: true;
+        readonly declaredMode: false;
+        readonly idempotencyKey: false;
+    };
+    readonly "excel.range.update": {
+        readonly kind: "saas";
+        readonly identities: readonly ["user"];
+        readonly readOnly: false;
+        readonly declaredMode: false;
+        readonly idempotencyKey: false;
+    };
+    readonly "excel.table.list": {
+        readonly kind: "saas";
+        readonly identities: readonly ["user"];
+        readonly readOnly: true;
+        readonly declaredMode: false;
+        readonly idempotencyKey: false;
+    };
+    readonly "excel.row.add": {
+        readonly kind: "saas";
+        readonly identities: readonly ["user"];
+        readonly readOnly: false;
+        readonly declaredMode: false;
+        readonly idempotencyKey: true;
+    };
+    readonly "excel.worksheet.add": {
+        readonly kind: "saas";
+        readonly identities: readonly ["user"];
+        readonly readOnly: false;
+        readonly declaredMode: false;
+        readonly idempotencyKey: true;
+    };
+    readonly "teams.message.list": {
+        readonly kind: "saas";
+        readonly identities: readonly ["user"];
+        readonly readOnly: true;
+        readonly declaredMode: false;
+        readonly idempotencyKey: false;
+    };
+    readonly "teams.message.post": {
+        readonly kind: "saas";
+        readonly identities: readonly ["user"];
+        readonly readOnly: false;
+        readonly declaredMode: false;
+        readonly idempotencyKey: true;
+    };
+    readonly "teams.reply.post": {
+        readonly kind: "saas";
+        readonly identities: readonly ["user"];
+        readonly readOnly: false;
+        readonly declaredMode: false;
+        readonly idempotencyKey: true;
+    };
     readonly "warehouse.view.read": {
         readonly kind: "database";
         readonly identities: readonly ["app"];