@fourier-labs/harbour-contracts 0.72.0 → 0.74.0

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

@@ -2,160 +2,598 @@
   "$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 (twelve operations since 0.71.0, ADR 0018): 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). 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, whose single attachment 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 (twelve operations since 0.71.0, ADR 0018): 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). 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, whose single attachment is bounded by its own 2 MiB.",
   "type": "object",
   "additionalProperties": false,
   "properties": {
     "messages": {
       "type": "array",
       "maxItems": 100,
-      "items": { "$ref": "#/definitions/ChannelMessage" }
-    },
-    "hasMore": { "type": "boolean" },
-    "nextCursor": { "type": "string", "minLength": 1, "maxLength": 256, "description": "slack.channel.history (0.71.0): the cursor of the next (older) page, present only when hasMore." },
-    "messageId": { "type": "string", "minLength": 1, "maxLength": 128 },
-    "channelId": { "type": "string", "pattern": "^[A-Z0-9]{5,20}$", "description": "slack.dm.send (0.71.0): the Slack DM channel id the message went to." },
-    "userId": { "type": "string", "minLength": 1, "maxLength": 128, "description": "slack.user.lookup (0.71.0): the Slack user id of the member with that email." },
-    "displayName": { "type": "string", "maxLength": 256, "description": "slack.user.lookup (0.71.0): the member's display name, or real name when they set no display name; may be empty." },
+      "items": {
+        "$ref": "#/definitions/ChannelMessage"
+      }
+    },
+    "hasMore": {
+      "type": "boolean"
+    },
+    "nextCursor": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 256,
+      "description": "slack.channel.history (0.71.0): the cursor of the next (older) page, present only when hasMore."
+    },
+    "messageId": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128
+    },
+    "channelId": {
+      "type": "string",
+      "pattern": "^[A-Z0-9]{5,20}$",
+      "description": "slack.dm.send (0.71.0): the Slack DM channel id the message went to."
+    },
+    "userId": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128,
+      "description": "slack.user.lookup (0.71.0): the Slack user id of the member with that email."
+    },
+    "displayName": {
+      "type": "string",
+      "maxLength": 256,
+      "description": "slack.user.lookup (0.71.0): the member's display name, or real name when they set no display name; may be empty."
+    },
     "threads": {
       "type": "array",
       "maxItems": 50,
-      "items": { "$ref": "#/definitions/GmailThread" }
-    },
-    "nextPageToken": { "type": "string", "minLength": 1, "maxLength": 256, "description": "gmail.thread.list (0.71.0): the token of the next page, present only when hasMore." },
-    "id": { "type": "string", "minLength": 1, "maxLength": 128 },
-    "threadId": { "type": "string", "minLength": 1, "maxLength": 128 },
-    "subject": { "type": "string", "maxLength": 2048 },
-    "from": { "type": "string", "maxLength": 2048 },
-    "to": { "type": "string", "maxLength": 8192 },
-    "date": { "type": "string", "maxLength": 128 },
-    "text": { "type": "string", "maxLength": 16384 },
-    "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." },
+      "items": {
+        "$ref": "#/definitions/GmailThread"
+      }
+    },
+    "nextPageToken": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 256,
+      "description": "gmail.thread.list (0.71.0): the token of the next page, present only when hasMore."
+    },
+    "id": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128
+    },
+    "threadId": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128
+    },
+    "subject": {
+      "type": "string",
+      "maxLength": 2048
+    },
+    "from": {
+      "type": "string",
+      "maxLength": 2048
+    },
+    "to": {
+      "type": "string",
+      "maxLength": 8192
+    },
+    "date": {
+      "type": "string",
+      "maxLength": 128
+    },
+    "text": {
+      "type": "string",
+      "maxLength": 16384
+    },
+    "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."
+    },
+    "sample": {
+      "type": "boolean",
+      "description": "warehouse.view.read (0.74.0): true when `rows` came from the app's sample rows (integration-execute-request.sampleRows) because the development read had no development copy of the source; the rows were never read from the source. Absent or false: the rows came from the source."
+    },
     "attachments": {
       "type": "array",
       "maxItems": 100,
-      "items": { "$ref": "#/definitions/GmailAttachment" },
+      "items": {
+        "$ref": "#/definitions/GmailAttachment"
+      },
       "description": "gmail.message.read (0.71.0): the message's attachments, without their bytes."
     },
     "emails": {
       "type": "array",
       "maxItems": 100,
-      "items": { "$ref": "#/definitions/GmailMessage" },
+      "items": {
+        "$ref": "#/definitions/GmailMessage"
+      },
       "description": "gmail.thread.read (0.71.0): every message of the thread, oldest first."
     },
-    "filename": { "type": "string", "minLength": 1, "maxLength": 255 },
-    "mimeType": { "type": "string", "minLength": 1, "maxLength": 128 },
-    "size": { "type": "integer", "minimum": 0, "description": "gmail.attachment.read (0.71.0): the attachment's size in bytes." },
-    "dataBase64": { "type": "string", "maxLength": 2796203, "description": "gmail.attachment.read (0.71.0): the attachment's bytes, standard base64, at most 2 MiB of bytes." },
+    "filename": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 255
+    },
+    "mimeType": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128
+    },
+    "size": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "gmail.attachment.read (0.71.0): the attachment's size in bytes."
+    },
+    "dataBase64": {
+      "type": "string",
+      "maxLength": 2796203,
+      "description": "gmail.attachment.read (0.71.0): the attachment's bytes, standard base64, at most 2 MiB of bytes."
+    },
     "rows": {
       "type": "array",
       "maxItems": 1000,
-      "items": { "type": "object", "additionalProperties": {}, "description": "One row keyed by the selected column names, or by the groupBy columns then the aggregate aliases." }
-    }
+      "items": {
+        "type": "object",
+        "additionalProperties": {},
+        "description": "One row keyed by the selected column names, or by the groupBy columns then the aggregate aliases."
+      }
+    },
+    "status": {
+      "type": "integer"
+    },
+    "headers": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "string"
+      }
+    },
+    "body": {}
   },
   "oneOf": [
-    { "required": ["messages", "hasMore"], "propertyNames": { "enum": ["messages", "hasMore", "nextCursor"] } },
-    { "required": ["messageId"], "maxProperties": 1 },
-    { "required": ["messageId", "threadId"], "maxProperties": 2 },
-    { "required": ["messageId", "channelId"], "maxProperties": 2 },
-    { "required": ["userId", "displayName"], "maxProperties": 2 },
-    { "required": ["threads", "hasMore"], "propertyNames": { "enum": ["threads", "hasMore", "nextPageToken"] } },
-    { "required": ["id", "emails"], "maxProperties": 2 },
-    { "required": ["id", "threadId", "subject", "from", "to", "date", "text", "truncated"], "propertyNames": { "enum": ["id", "threadId", "subject", "from", "to", "date", "text", "truncated", "attachments"] } },
-    { "required": ["filename", "mimeType", "size", "dataBase64"], "maxProperties": 4 },
-    { "required": ["rows"], "propertyNames": { "enum": ["rows", "truncated"] } }
+    {
+      "required": [
+        "messages",
+        "hasMore"
+      ],
+      "propertyNames": {
+        "enum": [
+          "messages",
+          "hasMore",
+          "nextCursor"
+        ]
+      }
+    },
+    {
+      "required": [
+        "messageId"
+      ],
+      "maxProperties": 1
+    },
+    {
+      "required": [
+        "messageId",
+        "threadId"
+      ],
+      "maxProperties": 2
+    },
+    {
+      "required": [
+        "messageId",
+        "channelId"
+      ],
+      "maxProperties": 2
+    },
+    {
+      "required": [
+        "userId",
+        "displayName"
+      ],
+      "maxProperties": 2
+    },
+    {
+      "required": [
+        "threads",
+        "hasMore"
+      ],
+      "propertyNames": {
+        "enum": [
+          "threads",
+          "hasMore",
+          "nextPageToken"
+        ]
+      }
+    },
+    {
+      "required": [
+        "id",
+        "emails"
+      ],
+      "maxProperties": 2
+    },
+    {
+      "required": [
+        "id",
+        "threadId",
+        "subject",
+        "from",
+        "to",
+        "date",
+        "text",
+        "truncated"
+      ],
+      "propertyNames": {
+        "enum": [
+          "id",
+          "threadId",
+          "subject",
+          "from",
+          "to",
+          "date",
+          "text",
+          "truncated",
+          "attachments"
+        ]
+      }
+    },
+    {
+      "required": [
+        "filename",
+        "mimeType",
+        "size",
+        "dataBase64"
+      ],
+      "maxProperties": 4
+    },
+    {
+      "required": [
+        "rows"
+      ],
+      "propertyNames": {
+        "enum": [
+          "rows",
+          "truncated",
+          "sample"
+        ]
+      }
+    }
   ],
   "definitions": {
     "GmailAttachment": {
       "type": "object",
       "additionalProperties": false,
-      "required": ["id", "filename", "mimeType", "size"],
+      "required": [
+        "id",
+        "filename",
+        "mimeType",
+        "size"
+      ],
       "description": "One attachment of a Gmail message (0.71.0), named without its bytes; gmail.attachment.read fetches them by `id`.",
       "properties": {
-        "id": { "type": "string", "minLength": 1, "maxLength": 512 },
-        "filename": { "type": "string", "maxLength": 255 },
-        "mimeType": { "type": "string", "maxLength": 128 },
-        "size": { "type": "integer", "minimum": 0, "description": "Bytes." }
+        "id": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 512
+        },
+        "filename": {
+          "type": "string",
+          "maxLength": 255
+        },
+        "mimeType": {
+          "type": "string",
+          "maxLength": 128
+        },
+        "size": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Bytes."
+        }
       }
     },
     "GmailMessage": {
       "type": "object",
       "additionalProperties": false,
-      "required": ["id", "threadId", "subject", "from", "to", "date", "text", "truncated"],
+      "required": [
+        "id",
+        "threadId",
+        "subject",
+        "from",
+        "to",
+        "date",
+        "text",
+        "truncated"
+      ],
       "description": "One message of a gmail.thread.read result (0.71.0): the gmail.message.read shape.",
       "properties": {
-        "id": { "type": "string", "minLength": 1, "maxLength": 128 },
-        "threadId": { "type": "string", "minLength": 1, "maxLength": 128 },
-        "subject": { "type": "string", "maxLength": 2048 },
-        "from": { "type": "string", "maxLength": 2048 },
-        "to": { "type": "string", "maxLength": 8192 },
-        "date": { "type": "string", "maxLength": 128 },
-        "text": { "type": "string", "maxLength": 16384 },
-        "truncated": { "type": "boolean" },
-        "attachments": { "type": "array", "maxItems": 100, "items": { "$ref": "#/definitions/GmailAttachment" } }
+        "id": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "threadId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "subject": {
+          "type": "string",
+          "maxLength": 2048
+        },
+        "from": {
+          "type": "string",
+          "maxLength": 2048
+        },
+        "to": {
+          "type": "string",
+          "maxLength": 8192
+        },
+        "date": {
+          "type": "string",
+          "maxLength": 128
+        },
+        "text": {
+          "type": "string",
+          "maxLength": 16384
+        },
+        "truncated": {
+          "type": "boolean"
+        },
+        "attachments": {
+          "type": "array",
+          "maxItems": 100,
+          "items": {
+            "$ref": "#/definitions/GmailAttachment"
+          }
+        }
       }
     },
     "GmailThread": {
       "type": "object",
       "additionalProperties": false,
-      "required": ["id", "messageId", "subject", "from", "date", "snippet"],
+      "required": [
+        "id",
+        "messageId",
+        "subject",
+        "from",
+        "date",
+        "snippet"
+      ],
       "properties": {
-        "id": { "type": "string", "minLength": 1, "maxLength": 128 },
-        "messageId": { "type": "string", "minLength": 1, "maxLength": 128 },
-        "subject": { "type": "string", "maxLength": 2048 },
-        "from": { "type": "string", "maxLength": 2048 },
-        "date": { "type": "string", "maxLength": 128 },
-        "snippet": { "type": "string", "maxLength": 4096 }
+        "id": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "messageId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "subject": {
+          "type": "string",
+          "maxLength": 2048
+        },
+        "from": {
+          "type": "string",
+          "maxLength": 2048
+        },
+        "date": {
+          "type": "string",
+          "maxLength": 128
+        },
+        "snippet": {
+          "type": "string",
+          "maxLength": 4096
+        }
       }
     },
     "ChannelMessage": {
       "type": "object",
       "additionalProperties": false,
-      "required": ["id", "text", "authorId", "createdAt"],
+      "required": [
+        "id",
+        "text",
+        "authorId",
+        "createdAt"
+      ],
       "properties": {
-        "id": { "type": "string", "minLength": 1, "maxLength": 128 },
-        "text": { "type": "string", "maxLength": 40000 },
-        "authorId": { "type": "string", "minLength": 1, "maxLength": 128 },
-        "createdAt": { "type": "string", "format": "date-time" },
-        "authorName": { "type": "string", "minLength": 1, "maxLength": 128, "description": "The display name a per-app-named app post carries (0.55.0; Slack's `username` on a customised bot message), so an app can recognise its own posts in a channel; absent on a person's message and on a post under the bot's own name." },
-        "authorIcon": { "type": "string", "pattern": "^:[a-z0-9_+-]{1,60}:$", "description": "The emoji shortcode such a post carries as its icon (0.55.0), when it has one; never an image URL." }
+        "id": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "text": {
+          "type": "string",
+          "maxLength": 40000
+        },
+        "authorId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "createdAt": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "authorName": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128,
+          "description": "The display name a per-app-named app post carries (0.55.0; Slack's `username` on a customised bot message), so an app can recognise its own posts in a channel; absent on a person's message and on a post under the bot's own name."
+        },
+        "authorIcon": {
+          "type": "string",
+          "pattern": "^:[a-z0-9_+-]{1,60}:$",
+          "description": "The emoji shortcode such a post carries as its icon (0.55.0), when it has one; never an image URL."
+        }
       }
     }
   },
   "examples": [
     {
-      "messages": [{ "id": "1725840000.000100", "text": "Shipped the weekly report.", "authorId": "U0123456", "createdAt": "2026-09-09T08:00:00Z" }],
+      "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" },
     {
-      "threads": [{ "id": "18f2c3a4b5d6e7f0", "messageId": "18f2c3a4b5d6e7f8", "subject": "Weekly report", "from": "Jane <jane@example.com>", "date": "2026-09-11T08:00:00Z", "snippet": "Shipped the weekly report." }],
+      "messageId": "1725840100.000200"
+    },
+    {
+      "messageId": "18f2c3a4b5d6e7f9",
+      "threadId": "18f2c3a4b5d6e7f0"
+    },
+    {
+      "threads": [
+        {
+          "id": "18f2c3a4b5d6e7f0",
+          "messageId": "18f2c3a4b5d6e7f8",
+          "subject": "Weekly report",
+          "from": "Jane <jane@example.com>",
+          "date": "2026-09-11T08:00:00Z",
+          "snippet": "Shipped the weekly report."
+        }
+      ],
       "hasMore": false
     },
-    { "id": "18f2c3a4b5d6e7f8", "threadId": "18f2c3a4b5d6e7f0", "subject": "Weekly report", "from": "Jane <jane@example.com>", "to": "team@example.com", "date": "2026-09-11T08:00:00Z", "text": "Shipped the weekly report.", "truncated": false },
-    { "rows": [{ "week": "2026-W36", "total": "1234.50" }] },
-    { "rows": [{ "region_code": "EMEA", "total_minor": "1234550", "invoices": "42" }, { "region_code": "APAC", "total_minor": "998000", "invoices": "17" }], "truncated": true },
     {
-      "messages": [{ "id": "1725840000.000100", "text": "Shipped the weekly report.", "authorId": "U0123456", "createdAt": "2026-09-09T08:00:00Z" }],
+      "id": "18f2c3a4b5d6e7f8",
+      "threadId": "18f2c3a4b5d6e7f0",
+      "subject": "Weekly report",
+      "from": "Jane <jane@example.com>",
+      "to": "team@example.com",
+      "date": "2026-09-11T08:00:00Z",
+      "text": "Shipped the weekly report.",
+      "truncated": false
+    },
+    {
+      "rows": [
+        {
+          "week": "2026-W36",
+          "total": "1234.50"
+        }
+      ]
+    },
+    {
+      "rows": [
+        {
+          "region_code": "EMEA",
+          "total_minor": "1234550",
+          "invoices": "42"
+        },
+        {
+          "region_code": "APAC",
+          "total_minor": "998000",
+          "invoices": "17"
+        }
+      ],
+      "truncated": true
+    },
+    {
+      "messages": [
+        {
+          "id": "1725840000.000100",
+          "text": "Shipped the weekly report.",
+          "authorId": "U0123456",
+          "createdAt": "2026-09-09T08:00:00Z"
+        }
+      ],
       "hasMore": true,
       "nextCursor": "bmV4dF90czoxNzI1ODQwMDAwMDAwMTAw"
     },
-    { "messageId": "1725840200.000300", "channelId": "D0123456DM" },
-    { "userId": "U0123456", "displayName": "Jane Doe" },
     {
-      "threads": [{ "id": "18f2c3a4b5d6e7f0", "messageId": "18f2c3a4b5d6e7f8", "subject": "Weekly report", "from": "Jane <jane@example.com>", "date": "2026-09-11T08:00:00Z", "snippet": "Shipped the weekly report." }],
+      "messageId": "1725840200.000300",
+      "channelId": "D0123456DM"
+    },
+    {
+      "userId": "U0123456",
+      "displayName": "Jane Doe"
+    },
+    {
+      "threads": [
+        {
+          "id": "18f2c3a4b5d6e7f0",
+          "messageId": "18f2c3a4b5d6e7f8",
+          "subject": "Weekly report",
+          "from": "Jane <jane@example.com>",
+          "date": "2026-09-11T08:00:00Z",
+          "snippet": "Shipped the weekly report."
+        }
+      ],
       "hasMore": true,
       "nextPageToken": "CAUQ0ZSH0b2DiwMg"
     },
     {
       "id": "18f2c3a4b5d6e7f0",
       "emails": [
-        { "id": "18f2c3a4b5d6e7f7", "threadId": "18f2c3a4b5d6e7f0", "subject": "Weekly report", "from": "Jane <jane@example.com>", "to": "team@example.com", "date": "2026-09-10T08:00:00Z", "text": "Draft attached.", "truncated": false, "attachments": [{ "id": "ANGjdJ8w9h1Q2k3L4m5N6o7P8q9R0s", "filename": "weekly-report.pdf", "mimeType": "application/pdf", "size": 48213 }] },
-        { "id": "18f2c3a4b5d6e7f8", "threadId": "18f2c3a4b5d6e7f0", "subject": "Re: Weekly report", "from": "Sam <sam@example.com>", "to": "team@example.com", "date": "2026-09-11T08:00:00Z", "text": "Shipped the weekly report.", "truncated": false }
+        {
+          "id": "18f2c3a4b5d6e7f7",
+          "threadId": "18f2c3a4b5d6e7f0",
+          "subject": "Weekly report",
+          "from": "Jane <jane@example.com>",
+          "to": "team@example.com",
+          "date": "2026-09-10T08:00:00Z",
+          "text": "Draft attached.",
+          "truncated": false,
+          "attachments": [
+            {
+              "id": "ANGjdJ8w9h1Q2k3L4m5N6o7P8q9R0s",
+              "filename": "weekly-report.pdf",
+              "mimeType": "application/pdf",
+              "size": 48213
+            }
+          ]
+        },
+        {
+          "id": "18f2c3a4b5d6e7f8",
+          "threadId": "18f2c3a4b5d6e7f0",
+          "subject": "Re: Weekly report",
+          "from": "Sam <sam@example.com>",
+          "to": "team@example.com",
+          "date": "2026-09-11T08:00:00Z",
+          "text": "Shipped the weekly report.",
+          "truncated": false
+        }
+      ]
+    },
+    {
+      "id": "18f2c3a4b5d6e7f7",
+      "threadId": "18f2c3a4b5d6e7f0",
+      "subject": "Weekly report",
+      "from": "Jane <jane@example.com>",
+      "to": "team@example.com",
+      "date": "2026-09-10T08:00:00Z",
+      "text": "Draft attached.",
+      "truncated": false,
+      "attachments": [
+        {
+          "id": "ANGjdJ8w9h1Q2k3L4m5N6o7P8q9R0s",
+          "filename": "weekly-report.pdf",
+          "mimeType": "application/pdf",
+          "size": 48213
+        }
       ]
     },
-    { "id": "18f2c3a4b5d6e7f7", "threadId": "18f2c3a4b5d6e7f0", "subject": "Weekly report", "from": "Jane <jane@example.com>", "to": "team@example.com", "date": "2026-09-10T08:00:00Z", "text": "Draft attached.", "truncated": false, "attachments": [{ "id": "ANGjdJ8w9h1Q2k3L4m5N6o7P8q9R0s", "filename": "weekly-report.pdf", "mimeType": "application/pdf", "size": 48213 }] },
-    { "filename": "weekly-report.pdf", "mimeType": "application/pdf", "size": 20, "dataBase64": "JVBERi0xLjQKJcOkw7zDtsOfCg==" }
+    {
+      "filename": "weekly-report.pdf",
+      "mimeType": "application/pdf",
+      "size": 20,
+      "dataBase64": "JVBERi0xLjQKJcOkw7zDtsOfCg=="
+    },
+    {
+      "rows": [
+        {
+          "week": "2026-W36",
+          "total": "1234.50"
+        }
+      ],
+      "truncated": false,
+      "sample": true
+    }
   ]
 }