@fourier-labs/harbour-contracts 0.84.0 → 0.86.0

package/schema/integration-execute-result.schema.json

@@ -2,7 +2,7 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://schemas.harbour.dev/integration-execute-result.schema.json",
   "title": "IntegrationExecuteResult",
-  "description": "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 \u2014 authorName/authorIcon, 0.55.0 \u2014 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` \u2014 the server reads limit+1 rows to know \u2014 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 \u2014 except a gmail.attachment.read or a sharepoint.file.read, whose single file is bounded by its own 2 MiB.",
+  "description": "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 \u2014 authorName/authorIcon, 0.55.0 \u2014 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` \u2014 the server reads limit+1 rows to know \u2014 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 \u2014 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.",
   "type": "object",
   "additionalProperties": false,
   "properties": {
@@ -54,18 +54,19 @@
       "type": "string",
       "minLength": 1,
       "maxLength": 2048,
-      "description": "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."
+      "description": "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."
     },
     "id": {
       "type": "string",
       "minLength": 1,
-      "maxLength": 256,
-      "description": "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)."
+      "maxLength": 1024,
+      "description": "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)."
     },
     "threadId": {
       "type": "string",
       "minLength": 1,
-      "maxLength": 128
+      "maxLength": 256,
+      "description": "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)."
     },
     "subject": {
       "type": "string",
@@ -85,11 +86,12 @@
     },
     "text": {
       "type": "string",
-      "maxLength": 16384
+      "maxLength": 65536,
+      "description": "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)."
     },
     "truncated": {
       "type": "boolean",
-      "description": "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."
+      "description": "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."
     },
     "sample": {
       "type": "boolean",
@@ -114,12 +116,14 @@
     "filename": {
       "type": "string",
       "minLength": 1,
-      "maxLength": 255
+      "maxLength": 255,
+      "description": "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."
     },
     "mimeType": {
       "type": "string",
       "minLength": 1,
-      "maxLength": 128
+      "maxLength": 128,
+      "description": "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)."
     },
     "size": {
       "type": "integer",
@@ -229,14 +233,192 @@
       "items": {
         "$ref": "#/definitions/SharePointFile"
       },
-      "description": "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."
+      "description": "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."
     },
     "webUrl": {
       "type": "string",
       "format": "uri",
       "minLength": 1,
       "maxLength": 2048,
-      "description": "sharepoint.item.create / sharepoint.file.upload (0.78.0): the SharePoint page of the new item or file, for a person to open."
+      "description": "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."
+    },
+    "calendars": {
+      "type": "array",
+      "maxItems": 100,
+      "items": {
+        "$ref": "#/definitions/CalendarListEntry"
+      },
+      "description": "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`."
+    },
+    "events": {
+      "type": "array",
+      "maxItems": 100,
+      "items": {
+        "$ref": "#/definitions/CalendarEvent"
+      },
+      "description": "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."
+    },
+    "title": {
+      "type": "string",
+      "maxLength": 2048,
+      "description": "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."
+    },
+    "start": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 64,
+      "description": "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."
+    },
+    "end": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 64,
+      "description": "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)."
+    },
+    "allDay": {
+      "type": "boolean",
+      "description": "calendar.event.read / outlook.event.read (0.86.0): whether the event spans whole days."
+    },
+    "timeZone": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 64,
+      "description": "calendar.event.read / outlook.event.read (0.86.0): the IANA zone the event is shown in, when the provider reports one."
+    },
+    "location": {
+      "type": "string",
+      "maxLength": 2048,
+      "description": "calendar.event.read / outlook.event.read (0.86.0): where the event is, as free text, when set."
+    },
+    "description": {
+      "type": "string",
+      "maxLength": 16384,
+      "description": "calendar.event.read / outlook.event.read (0.86.0): the event's description as plain text, cut at 16 KiB, when set."
+    },
+    "attendees": {
+      "type": "array",
+      "maxItems": 500,
+      "items": {
+        "$ref": "#/definitions/CalendarAttendee"
+      },
+      "description": "calendar.event.read / outlook.event.read (0.86.0): who is invited and how they answered; empty when the event has no attendees."
+    },
+    "organizer": {
+      "$ref": "#/definitions/CalendarAttendee",
+      "description": "calendar.event.read / outlook.event.read (0.86.0): who organises the event, when the provider reports one."
+    },
+    "eventStatus": {
+      "$ref": "#/definitions/CalendarEventStatus",
+      "description": "calendar.event.read / outlook.event.read (0.86.0): confirmed, tentative or cancelled. Named apart from `status`, the HTTP status of a service.request result."
+    },
+    "revisionId": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 256,
+      "description": "docs.document.read / docs.document.append (0.86.0): the document's revision after the read or the append, as Google names it."
+    },
+    "replaced": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "docs.text.replace (0.86.0): how many occurrences were replaced over all the pairs."
+    },
+    "sheets": {
+      "type": "array",
+      "maxItems": 200,
+      "items": {
+        "$ref": "#/definitions/SheetProperties"
+      },
+      "description": "sheets.spreadsheet.read (0.86.0): the spreadsheet's sheets in tab order, with their grid sizes."
+    },
+    "range": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 256,
+      "description": "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)."
+    },
+    "values": {
+      "type": "array",
+      "maxItems": 1000,
+      "items": {
+        "type": "array",
+        "maxItems": 100,
+        "items": {
+          "oneOf": [
+            {
+              "type": "string",
+              "maxLength": 50000
+            },
+            {
+              "type": "number"
+            },
+            {
+              "type": "boolean"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      },
+      "description": "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."
+    },
+    "updatedRows": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "sheets.values.append / excel.row.add (0.86.0): how many rows were written."
+    },
+    "updatedCells": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "sheets.values.update / excel.range.update (0.86.0): how many cells were written."
+    },
+    "worksheets": {
+      "type": "array",
+      "maxItems": 500,
+      "items": {
+        "$ref": "#/definitions/ExcelWorksheet"
+      },
+      "description": "excel.worksheet.list (0.86.0): the workbook's worksheets in tab order."
+    },
+    "address": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 256,
+      "description": "excel.range.read / excel.range.update (0.86.0): the range Excel answered with, e.g. `Orders!A1:D10`."
+    },
+    "tables": {
+      "type": "array",
+      "maxItems": 500,
+      "items": {
+        "$ref": "#/definitions/ExcelTable"
+      },
+      "description": "excel.table.list (0.86.0): the workbook's or the worksheet's tables; `name` is what excel.row.add takes as `tableName`."
+    },
+    "index": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "excel.row.add (0.86.0): the zero-based index, within the table, of the first row added."
+    },
+    "name": {
+      "type": "string",
+      "maxLength": 256,
+      "description": "excel.worksheet.add (0.86.0): the new worksheet's name."
+    },
+    "mailMessages": {
+      "type": "array",
+      "maxItems": 100,
+      "items": {
+        "$ref": "#/definitions/OutlookMessageSummary"
+      },
+      "description": "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."
+    },
+    "teamsMessages": {
+      "type": "array",
+      "maxItems": 100,
+      "items": {
+        "$ref": "#/definitions/TeamsMessage"
+      },
+      "description": "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."
     },
     "status": {
       "type": "integer"
@@ -528,6 +710,187 @@
         "dataBase64"
       ],
       "maxProperties": 5
+    },
+    {
+      "required": [
+        "calendars",
+        "hasMore"
+      ],
+      "propertyNames": {
+        "enum": [
+          "calendars",
+          "hasMore",
+          "nextPageToken"
+        ]
+      }
+    },
+    {
+      "required": [
+        "events",
+        "hasMore"
+      ],
+      "propertyNames": {
+        "enum": [
+          "events",
+          "hasMore",
+          "nextPageToken"
+        ]
+      }
+    },
+    {
+      "required": [
+        "id",
+        "title",
+        "start",
+        "end",
+        "allDay",
+        "attendees",
+        "webUrl",
+        "eventStatus"
+      ],
+      "propertyNames": {
+        "enum": [
+          "id",
+          "title",
+          "start",
+          "end",
+          "allDay",
+          "timeZone",
+          "location",
+          "description",
+          "attendees",
+          "organizer",
+          "webUrl",
+          "eventStatus"
+        ]
+      }
+    },
+    {
+      "required": [
+        "id",
+        "title",
+        "text",
+        "revisionId",
+        "webUrl",
+        "truncated"
+      ],
+      "maxProperties": 6
+    },
+    {
+      "required": [
+        "id",
+        "revisionId"
+      ],
+      "maxProperties": 2
+    },
+    {
+      "required": [
+        "id",
+        "replaced"
+      ],
+      "maxProperties": 2
+    },
+    {
+      "required": [
+        "id",
+        "title",
+        "sheets",
+        "webUrl"
+      ],
+      "maxProperties": 4
+    },
+    {
+      "required": [
+        "range",
+        "values"
+      ],
+      "maxProperties": 2
+    },
+    {
+      "required": [
+        "range",
+        "updatedRows"
+      ],
+      "maxProperties": 2
+    },
+    {
+      "required": [
+        "range",
+        "updatedCells"
+      ],
+      "maxProperties": 2
+    },
+    {
+      "required": [
+        "range"
+      ],
+      "maxProperties": 1
+    },
+    {
+      "required": [
+        "worksheets"
+      ],
+      "maxProperties": 1
+    },
+    {
+      "required": [
+        "address",
+        "values"
+      ],
+      "maxProperties": 2
+    },
+    {
+      "required": [
+        "address",
+        "updatedCells"
+      ],
+      "maxProperties": 2
+    },
+    {
+      "required": [
+        "tables"
+      ],
+      "maxProperties": 1
+    },
+    {
+      "required": [
+        "index",
+        "updatedRows"
+      ],
+      "maxProperties": 2
+    },
+    {
+      "required": [
+        "id",
+        "name"
+      ],
+      "maxProperties": 2
+    },
+    {
+      "required": [
+        "mailMessages",
+        "hasMore"
+      ],
+      "propertyNames": {
+        "enum": [
+          "mailMessages",
+          "hasMore",
+          "nextPageToken"
+        ]
+      }
+    },
+    {
+      "required": [
+        "teamsMessages",
+        "hasMore"
+      ],
+      "propertyNames": {
+        "enum": [
+          "teamsMessages",
+          "hasMore",
+          "nextPageToken"
+        ]
+      }
     }
   ],
   "definitions": {
@@ -1079,7 +1442,7 @@
         "webUrl",
         "modifiedAt"
       ],
-      "description": "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.",
+      "description": "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`.",
       "properties": {
         "id": {
           "$ref": "app-integrations-declaration.schema.json#/definitions/GraphId"
@@ -1111,25 +1474,339 @@
           "format": "date-time"
         }
       }
-    }
-  },
-  "examples": [
-    {
-      "messages": [
-        {
-          "id": "1725840000.000100",
-          "text": "Shipped the weekly report.",
-          "authorId": "U0123456",
-          "createdAt": "2026-09-09T08:00:00Z"
-        }
-      ],
-      "hasMore": false
-    },
-    {
-      "messageId": "1725840100.000200"
     },
-    {
-      "messageId": "18f2c3a4b5d6e7f9",
+    "CalendarListEntry": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "name",
+        "primary",
+        "accessRole"
+      ],
+      "description": "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).",
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "name": {
+          "type": "string",
+          "maxLength": 256
+        },
+        "primary": {
+          "type": "boolean"
+        },
+        "accessRole": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 32
+        }
+      }
+    },
+    "CalendarEventStatus": {
+      "type": "string",
+      "enum": [
+        "confirmed",
+        "tentative",
+        "cancelled"
+      ],
+      "description": "An event's state (0.86.0): confirmed (Google `confirmed`, Graph not cancelled and not tentative), tentative, or cancelled."
+    },
+    "CalendarAttendee": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "email"
+      ],
+      "description": "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.",
+      "properties": {
+        "email": {
+          "type": "string",
+          "maxLength": 254
+        },
+        "name": {
+          "type": "string",
+          "maxLength": 256
+        },
+        "response": {
+          "type": "string",
+          "enum": [
+            "accepted",
+            "declined",
+            "tentative",
+            "needsAction"
+          ]
+        }
+      }
+    },
+    "CalendarEvent": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "title",
+        "start",
+        "end",
+        "allDay",
+        "attendees",
+        "webUrl",
+        "eventStatus"
+      ],
+      "description": "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`.",
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 1024
+        },
+        "title": {
+          "type": "string",
+          "maxLength": 2048
+        },
+        "start": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 64
+        },
+        "end": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 64
+        },
+        "allDay": {
+          "type": "boolean"
+        },
+        "timeZone": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 64
+        },
+        "location": {
+          "type": "string",
+          "maxLength": 2048
+        },
+        "description": {
+          "type": "string",
+          "maxLength": 16384
+        },
+        "attendees": {
+          "type": "array",
+          "maxItems": 500,
+          "items": {
+            "$ref": "#/definitions/CalendarAttendee"
+          }
+        },
+        "organizer": {
+          "$ref": "#/definitions/CalendarAttendee"
+        },
+        "webUrl": {
+          "type": "string",
+          "format": "uri",
+          "minLength": 1,
+          "maxLength": 2048
+        },
+        "eventStatus": {
+          "$ref": "#/definitions/CalendarEventStatus"
+        }
+      }
+    },
+    "SheetProperties": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "title",
+        "rows",
+        "columns"
+      ],
+      "description": "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.",
+      "properties": {
+        "id": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "title": {
+          "type": "string",
+          "maxLength": 256
+        },
+        "rows": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "columns": {
+          "type": "integer",
+          "minimum": 0
+        }
+      }
+    },
+    "OutlookMessageSummary": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "conversationId",
+        "subject",
+        "from",
+        "to",
+        "receivedAt",
+        "preview",
+        "hasAttachments",
+        "webUrl"
+      ],
+      "description": "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`.",
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "conversationId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "subject": {
+          "type": "string",
+          "maxLength": 2048
+        },
+        "from": {
+          "type": "string",
+          "maxLength": 2048
+        },
+        "to": {
+          "type": "string",
+          "maxLength": 8192
+        },
+        "receivedAt": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "preview": {
+          "type": "string",
+          "maxLength": 1024
+        },
+        "hasAttachments": {
+          "type": "boolean"
+        },
+        "webUrl": {
+          "type": "string",
+          "format": "uri",
+          "minLength": 1,
+          "maxLength": 2048
+        }
+      }
+    },
+    "ExcelWorksheet": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "name",
+        "position"
+      ],
+      "description": "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.",
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "name": {
+          "type": "string",
+          "maxLength": 256
+        },
+        "position": {
+          "type": "integer",
+          "minimum": 0
+        }
+      }
+    },
+    "ExcelTable": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "name",
+        "worksheet"
+      ],
+      "description": "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.",
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "name": {
+          "type": "string",
+          "maxLength": 256
+        },
+        "worksheet": {
+          "type": "string",
+          "maxLength": 256
+        }
+      }
+    },
+    "TeamsMessage": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "from",
+        "text",
+        "createdAt",
+        "webUrl"
+      ],
+      "description": "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`.",
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "from": {
+          "type": "string",
+          "maxLength": 256
+        },
+        "text": {
+          "type": "string",
+          "maxLength": 16384
+        },
+        "createdAt": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "webUrl": {
+          "type": "string",
+          "format": "uri",
+          "minLength": 1,
+          "maxLength": 2048
+        },
+        "replyCount": {
+          "type": "integer",
+          "minimum": 0
+        }
+      }
+    }
+  },
+  "examples": [
+    {
+      "messages": [
+        {
+          "id": "1725840000.000100",
+          "text": "Shipped the weekly report.",
+          "authorId": "U0123456",
+          "createdAt": "2026-09-09T08:00:00Z"
+        }
+      ],
+      "hasMore": false
+    },
+    {
+      "messageId": "1725840100.000200"
+    },
+    {
+      "messageId": "18f2c3a4b5d6e7f9",
       "threadId": "18f2c3a4b5d6e7f0"
     },
     {
@@ -1476,6 +2153,233 @@
       "id": "01BYE5RZ7KQJ2A3BUFOFD3GSPGOHDJD37L",
       "filename": "weekly-report 1.pdf",
       "webUrl": "https://fourier.sharepoint.com/sites/intranet/Shared%20Documents/Reports/weekly-report%201.pdf"
+    },
+    {
+      "calendars": [
+        {
+          "id": "saketh@example.com",
+          "name": "Saketh",
+          "primary": true,
+          "accessRole": "owner"
+        },
+        {
+          "id": "c_1a2b3c4d5e6f7g8h9i0j@group.calendar.google.com",
+          "name": "Engineering",
+          "primary": false,
+          "accessRole": "writer"
+        }
+      ],
+      "hasMore": false
+    },
+    {
+      "events": [
+        {
+          "id": "7qk2m9f4c1a8b3d5e6f7g8h9i0",
+          "title": "Sprint review",
+          "start": "2026-10-21T09:00:00+05:30",
+          "end": "2026-10-21T10:00:00+05:30",
+          "allDay": false,
+          "timeZone": "Asia/Kolkata",
+          "location": "Room 4",
+          "description": "Demo of the weekly report app.",
+          "attendees": [
+            {
+              "email": "jane@example.com",
+              "name": "Jane Doe",
+              "response": "accepted"
+            },
+            {
+              "email": "sam@example.com",
+              "response": "needsAction"
+            }
+          ],
+          "organizer": {
+            "email": "saketh@example.com",
+            "name": "Saketh"
+          },
+          "webUrl": "https://www.google.com/calendar/event?eid=N3FrMm05ZjRjMWE4YjNkNWU2ZjdnOGg5aTAgamFuZUBleGFtcGxlLmNvbQ",
+          "eventStatus": "confirmed"
+        }
+      ],
+      "hasMore": true,
+      "nextPageToken": "CigKGjdxazJtOWY0YzFhOGIzZDVlNmY3ZzhoOWkwGAEggIDA6rOW-wIaDQgAEgAYASCA"
+    },
+    {
+      "id": "7qk2m9f4c1a8b3d5e6f7g8h9i0",
+      "title": "Sprint review",
+      "start": "2026-10-21T09:00:00+05:30",
+      "end": "2026-10-21T10:00:00+05:30",
+      "allDay": false,
+      "timeZone": "Asia/Kolkata",
+      "location": "Room 4",
+      "description": "Demo of the weekly report app.",
+      "attendees": [
+        {
+          "email": "jane@example.com",
+          "name": "Jane Doe",
+          "response": "accepted"
+        },
+        {
+          "email": "sam@example.com",
+          "response": "needsAction"
+        }
+      ],
+      "organizer": {
+        "email": "saketh@example.com",
+        "name": "Saketh"
+      },
+      "webUrl": "https://www.google.com/calendar/event?eid=N3FrMm05ZjRjMWE4YjNkNWU2ZjdnOGg5aTAgamFuZUBleGFtcGxlLmNvbQ",
+      "eventStatus": "confirmed"
+    },
+    {
+      "id": "1x2y3z4A5B6C7D8E9F0G1H2I3J4K5L6M7N8O9P0Q1R2S",
+      "title": "Weekly report, week 42",
+      "text": "Shipped the weekly report app.\n\nNext: the Sheets export.",
+      "revisionId": "ALBJ4LtK9Qx2mYhR3nV0pWcE7sD1fG8hJ",
+      "webUrl": "https://docs.google.com/document/d/1x2y3z4A5B6C7D8E9F0G1H2I3J4K5L6M7N8O9P0Q1R2S/edit",
+      "truncated": false
+    },
+    {
+      "id": "1x2y3z4A5B6C7D8E9F0G1H2I3J4K5L6M7N8O9P0Q1R2S",
+      "revisionId": "ALBJ4LtL0Ry3nZiS4oW1qXdF8tE2gH9iK"
+    },
+    {
+      "id": "1x2y3z4A5B6C7D8E9F0G1H2I3J4K5L6M7N8O9P0Q1R2S",
+      "replaced": 3
+    },
+    {
+      "id": "1qW2eR3tY4uI5oP6aS7dF8gH9jK0lZ1xC2vB3nM4Q5w6",
+      "title": "Q4 pipeline",
+      "sheets": [
+        {
+          "id": 0,
+          "title": "Deals",
+          "rows": 1000,
+          "columns": 26
+        },
+        {
+          "id": 1498710651,
+          "title": "Notes",
+          "rows": 1000,
+          "columns": 26
+        }
+      ],
+      "webUrl": "https://docs.google.com/spreadsheets/d/1qW2eR3tY4uI5oP6aS7dF8gH9jK0lZ1xC2vB3nM4Q5w6/edit"
+    },
+    {
+      "range": "Orders!A1:D3",
+      "values": [
+        [
+          "date",
+          "invoice",
+          "amount",
+          "paid"
+        ],
+        [
+          "2026-10-17",
+          "INV-1042",
+          1250.5,
+          true
+        ],
+        [
+          "2026-10-17",
+          "INV-1043",
+          980,
+          false
+        ]
+      ]
+    },
+    {
+      "range": "Orders!A4:D5",
+      "updatedRows": 2
+    },
+    {
+      "range": "Orders!C2:D2",
+      "updatedCells": 2
+    },
+    {
+      "range": "Orders!A2:D1000"
+    },
+    {
+      "mailMessages": [
+        {
+          "id": "AAMkAGI2THVSAAA-ZmQ0NzY2M2EtMDAwMC00YzI4LWFhYTEtYmJjYzEyMzQ1Njc4AQAAAAAAWbKCSXNo0UOjEqSs3Og1AAA=",
+          "conversationId": "AAQkAGI2THVSAAAQAK5f9c0P2kZEoYw3QmX3xYQ=",
+          "subject": "Weekly report",
+          "from": "Jane Doe <jane@example.com>",
+          "to": "saketh@example.com",
+          "receivedAt": "2026-10-17T08:00:00Z",
+          "preview": "The weekly report is attached.",
+          "hasAttachments": true,
+          "webUrl": "https://outlook.office365.com/owa/?ItemID=AAMkAGI2THVSAAA%3D&exvsurl=1&viewmodel=ReadMessageItem"
+        }
+      ],
+      "hasMore": false
+    },
+    {
+      "worksheets": [
+        {
+          "id": "{00000000-0001-0000-0000-000000000000}",
+          "name": "Orders",
+          "position": 0
+        },
+        {
+          "id": "{00000000-0001-0000-0100-000000000000}",
+          "name": "Week 42",
+          "position": 1
+        }
+      ]
+    },
+    {
+      "address": "Orders!A1:D2",
+      "values": [
+        [
+          "date",
+          "invoice",
+          "amount",
+          "paid"
+        ],
+        [
+          "2026-10-17",
+          "INV-1042",
+          1250.5,
+          true
+        ]
+      ]
+    },
+    {
+      "address": "Orders!C2:D2",
+      "updatedCells": 2
+    },
+    {
+      "tables": [
+        {
+          "id": "{5A3B2C1D-0000-0000-0000-000000000001}",
+          "name": "OrdersTable",
+          "worksheet": "Orders"
+        }
+      ]
+    },
+    {
+      "index": 41,
+      "updatedRows": 1
+    },
+    {
+      "id": "{00000000-0001-0000-0100-000000000000}",
+      "name": "Week 42"
+    },
+    {
+      "teamsMessages": [
+        {
+          "id": "1729159200123",
+          "from": "Jane Doe",
+          "text": "Weekly report posted.",
+          "createdAt": "2026-10-17T08:00:00.123Z",
+          "webUrl": "https://teams.microsoft.com/l/message/19%3Aa1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6%40thread.tacv2/1729159200123?tenantId=3f2c9b1e-7d4a-4c6b-9e8f-0a1b2c3d4e5f",
+          "replyCount": 2
+        }
+      ],
+      "hasMore": false
     }
   ]
 }