@fourier-labs/harbour-contracts 0.77.0 → 0.78.0

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

@@ -2,7 +2,7 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://schemas.harbour.dev/integration-execute-request.schema.json",
   "title": "IntegrationExecuteRequest",
-  "description": "Body of POST /_harbour/integrations/execute (app SDK), forwarded unchanged to the governance development and runtime execute routes. Exactly one declared operation against one declared resource. The identity mode is fixed by the operation for every operation but the declared-mode Slack operations (slack.channel.history, slack.message.post, slack.message.update, slack.message.delete; 0.71.0 widened history), and always enforced from an approved grant; any identity/userId/scope field is rejected by additionalProperties. A declared-mode operation runs as the app (for a post: the IT-approved per-app name from the grant, plus a \"Posted by <app> on Isomorph\" footer) or as the signed-in person (no name, no footer) \u2014 the same input either way \u2014 and since 0.55.0 the call names which of the app's approved modes it runs under (`mode`): required when IT approved both modes for the app (MODE_REQUIRED otherwise), optional when it approved one (that one is used), and a named mode without an approved grant is refused (MODE_NOT_GRANTED) rather than served under the other, so approval order never decides what a call does. Per-operation input bounds (0.71.0, ADR 0018): slack.channel.history {limit? 1..100, default 15, cursor?, oldest?, latest?}; slack.message.post {text 1..4000 chars, threadId?, format? plain|mrkdwn} and a required idempotencyKey retained across retries of one explicit Send; slack.message.update {messageId, text, format?}; slack.message.delete {messageId}; slack.dm.send {to 1..8 addresses, text, format?} (app mode only) with a required idempotencyKey; slack.user.lookup {email}; gmail.thread.list {limit? 1..50, default 15, q?, labelIds? default [INBOX], pageToken?}; gmail.thread.read {threadId}; gmail.message.read {messageId}; gmail.attachment.read {messageId, attachmentId}; gmail.message.send {to 1..50 addresses (to+cc+bcc <= 50 in total), cc?, bcc?, subject 1..256 chars, text 1..4000 chars, html? <= 64 KiB, attachments? 1..5 of <= 2 MiB each as base64, replyToMessageId?} and a required idempotencyKey like slack.message.post; warehouse.view.read {columns? 1..32, where? 1..16 filters, groupBy? 1..8 columns, aggregates? 1..16, orderBy? 1..8, limit? 1..1000, default 100} (0.70.0: a plain read names columns, an aggregate read names aggregates and optionally groupBy; the cross-field rules \u2014 exactly one of columns or aggregates, groupBy needs aggregates, a filter value that fits its op, orderBy naming a returned column, every named column approved \u2014 are enforced by governance, not expressible here; ADR 0017). Basecamp (0.76.0, ADR 0022; every id a string of 1..20 digits, every operation user mode): basecamp.project.list {pageToken?, projectStatus? active|archived} on the fixed `account` alias; on a project alias basecamp.todolist.list {pageToken?}; basecamp.todo.list {todolistId, completed?, pageToken?}; basecamp.todo.create {todolistId, content 1..1000 (the to-do title), description? <= 16384, contentFormat? plain|html, dueOn? YYYY-MM-DD, assigneeIds? 1..20, notify?} with a required idempotencyKey; basecamp.todo.complete {todoId} (idempotent at Basecamp, so no key); basecamp.message.list {pageToken?}; basecamp.message.post {subject 1..256, content 1..65536, contentFormat?} with a required idempotencyKey; basecamp.comment.list {recordingId, pageToken?}; basecamp.comment.post {recordingId, content 1..16384, contentFormat?} with a required idempotencyKey; basecamp.campfire.post {content 1..4000, contentFormat?} with a required idempotencyKey; basecamp.people.list {pageToken?}. `pageToken` is the previous page's `nextPageToken` (a Basecamp page number as digits). Each operation's then-block is the one statement of its input rules: propertyNames.enum names the fields it accepts, required the ones it needs, and per-field overrides (maximum, default) narrow the shared property. Codegen derives IntegrationExecuteInputRules and validateIntegrationExecuteInput (gen-ts/integration-execute-input-rules.ts, gen-go/integration_execute_input_rules.go) from exactly these blocks, so the governance execute route, the app SDK and the kit's local check refuse the same request with the same message. Transport limits (not expressible here): request <= 16 KiB except a gmail.message.send carrying attachments (governance sizes that route for the attachment bound) and a basecamp.message.post (its 64 KiB body; governance allows 80 KiB there), total deadline 10 s.",
+  "description": "Body of POST /_harbour/integrations/execute (app SDK), forwarded unchanged to the governance development and runtime execute routes. Exactly one declared operation against one declared resource. The identity mode is fixed by the operation for every operation but the declared-mode Slack operations (slack.channel.history, slack.message.post, slack.message.update, slack.message.delete; 0.71.0 widened history), and always enforced from an approved grant; any identity/userId/scope field is rejected by additionalProperties. A declared-mode operation runs as the app (for a post: the IT-approved per-app name from the grant, plus a \"Posted by <app> on Isomorph\" footer) or as the signed-in person (no name, no footer) \u2014 the same input either way \u2014 and since 0.55.0 the call names which of the app's approved modes it runs under (`mode`): required when IT approved both modes for the app (MODE_REQUIRED otherwise), optional when it approved one (that one is used), and a named mode without an approved grant is refused (MODE_NOT_GRANTED) rather than served under the other, so approval order never decides what a call does. Per-operation input bounds (0.71.0, ADR 0018): slack.channel.history {limit? 1..100, default 15, cursor?, oldest?, latest?}; slack.message.post {text 1..4000 chars, threadId?, format? plain|mrkdwn} and a required idempotencyKey retained across retries of one explicit Send; slack.message.update {messageId, text, format?}; slack.message.delete {messageId}; slack.dm.send {to 1..8 addresses, text, format?} (app mode only) with a required idempotencyKey; slack.user.lookup {email}; gmail.thread.list {limit? 1..50, default 15, q?, labelIds? default [INBOX], pageToken?}; gmail.thread.read {threadId}; gmail.message.read {messageId}; gmail.attachment.read {messageId, attachmentId}; gmail.message.send {to 1..50 addresses (to+cc+bcc <= 50 in total), cc?, bcc?, subject 1..256 chars, text 1..4000 chars, html? <= 64 KiB, attachments? 1..5 of <= 2 MiB each as base64, replyToMessageId?} and a required idempotencyKey like slack.message.post; warehouse.view.read {columns? 1..32, where? 1..16 filters, groupBy? 1..8 columns, aggregates? 1..16, orderBy? 1..8, limit? 1..1000, default 100} (0.70.0: a plain read names columns, an aggregate read names aggregates and optionally groupBy; the cross-field rules \u2014 exactly one of columns or aggregates, groupBy needs aggregates, a filter value that fits its op, orderBy naming a returned column, every named column approved \u2014 are enforced by governance, not expressible here; ADR 0017). Basecamp (0.76.0, ADR 0022; every id a string of 1..20 digits, every operation user mode): basecamp.project.list {pageToken?, projectStatus? active|archived} on the fixed `account` alias; on a project alias basecamp.todolist.list {pageToken?}; basecamp.todo.list {todolistId, completed?, pageToken?}; basecamp.todo.create {todolistId, content 1..1000 (the to-do title), description? <= 16384, contentFormat? plain|html, dueOn? YYYY-MM-DD, assigneeIds? 1..20, notify?} with a required idempotencyKey; basecamp.todo.complete {todoId} (idempotent at Basecamp, so no key); basecamp.message.list {pageToken?}; basecamp.message.post {subject 1..256, content 1..65536, contentFormat?} with a required idempotencyKey; basecamp.comment.list {recordingId, pageToken?}; basecamp.comment.post {recordingId, content 1..16384, contentFormat?} with a required idempotencyKey; basecamp.campfire.post {content 1..4000, contentFormat?} with a required idempotencyKey; basecamp.people.list {pageToken?}. `pageToken` is the previous page's `nextPageToken` (a Basecamp page number as digits). SharePoint (0.78.0, ADR 0024; every id a Microsoft Graph id — GraphId, 1..256 characters — every operation user mode on a site alias): sharepoint.list.list {pageToken?}; sharepoint.item.list {listId, filter? 1..512 (an OData filter on `fields/...`), pageToken?}; sharepoint.item.create {listId, fields (1..32 columns, each a string <= 4000, a number, a boolean or null)} with a required idempotencyKey; sharepoint.item.update {listId, itemId, fields} (a PATCH, idempotent at Graph, so no key); sharepoint.drive.list {pageToken?}; sharepoint.file.list {driveId?, folderId?, pageToken?} (no driveId: the site's default drive; no folderId: its root); sharepoint.file.search {q 1..256, driveId?, pageToken?}; sharepoint.file.read {fileId, driveId?}; sharepoint.file.upload {filename 1..255, contentType, dataBase64 <= 2 MiB, driveId?, folderId?, conflict? rename|replace|fail} with a required idempotencyKey. A SharePoint `pageToken` is Graph's `$skiptoken` (up to 2048 characters; the shared field is that wide, the Gmail and Basecamp operations narrow it back to 256). Each operation's then-block is the one statement of its input rules: propertyNames.enum names the fields it accepts, required the ones it needs, and per-field overrides (maximum, default) narrow the shared property. Codegen derives IntegrationExecuteInputRules and validateIntegrationExecuteInput (gen-ts/integration-execute-input-rules.ts, gen-go/integration_execute_input_rules.go) from exactly these blocks, so the governance execute route, the app SDK and the kit's local check refuse the same request with the same message. Transport limits (not expressible here): request <= 16 KiB except a gmail.message.send carrying attachments (governance sizes that route for the attachment bound) and a basecamp.message.post (its 64 KiB body; governance allows 80 KiB there) and a sharepoint.file.upload (its 2 MiB file as base64; governance sizes it like the Gmail attachment route), total deadline 10 s.",
   "type": "object",
   "additionalProperties": false,
   "required": [
@@ -78,7 +78,7 @@
           "type": "string",
           "minLength": 1,
           "maxLength": 256,
-          "description": "gmail.thread.list (0.71.0): a Gmail search query (the search-box syntax, e.g. `from:jane newer_than:7d`)."
+          "description": "gmail.thread.list (0.71.0): a Gmail search query (the search-box syntax, e.g. `from:jane newer_than:7d`). sharepoint.file.search (0.78.0): the words to search a drive's file names and contents for."
         },
         "labelIds": {
           "type": "array",
@@ -98,8 +98,8 @@
         "pageToken": {
           "type": "string",
           "minLength": 1,
-          "maxLength": 256,
-          "description": "gmail.thread.list (0.71.0) and every basecamp.*.list operation (0.76.0): the `nextPageToken` of the previous page; absent reads the first page."
+          "maxLength": 2048,
+          "description": "gmail.thread.list (0.71.0), every basecamp.*.list operation (0.76.0) and the paged sharepoint.* reads (0.78.0: list.list, item.list, drive.list, file.list, file.search): the `nextPageToken` of the previous page; absent reads the first page. At most 2048 characters for a Graph `$skiptoken`; the Gmail and Basecamp operations narrow it to 256."
         },
         "email": {
           "$ref": "#/definitions/EmailAddress",
@@ -198,6 +198,77 @@
           "$ref": "#/definitions/BasecampProjectStatus",
           "description": "basecamp.project.list (0.76.0): which projects to list; active when absent."
         },
+        "listId": {
+          "$ref": "app-integrations-declaration.schema.json#/definitions/GraphId",
+          "description": "sharepoint.item.list / sharepoint.item.create / sharepoint.item.update (0.78.0): the SharePoint list, as a sharepoint.list.list result named it."
+        },
+        "itemId": {
+          "$ref": "app-integrations-declaration.schema.json#/definitions/GraphId",
+          "description": "sharepoint.item.update (0.78.0): the list item, as a sharepoint.item.list or sharepoint.item.create result named it."
+        },
+        "driveId": {
+          "$ref": "app-integrations-declaration.schema.json#/definitions/GraphId",
+          "description": "sharepoint.file.list / sharepoint.file.search / sharepoint.file.read / sharepoint.file.upload (0.78.0): the document library, as a sharepoint.drive.list result named it; absent means the site's default drive (its Documents library)."
+        },
+        "folderId": {
+          "$ref": "app-integrations-declaration.schema.json#/definitions/GraphId",
+          "description": "sharepoint.file.list / sharepoint.file.upload (0.78.0): the folder to list or upload into, as a sharepoint.file.list result named it (an entry with isFolder); absent means the drive's root."
+        },
+        "fileId": {
+          "$ref": "app-integrations-declaration.schema.json#/definitions/GraphId",
+          "description": "sharepoint.file.read (0.78.0): the file, as a sharepoint.file.list, sharepoint.file.search or sharepoint.file.upload result named it."
+        },
+        "fields": {
+          "type": "object",
+          "minProperties": 1,
+          "maxProperties": 32,
+          "additionalProperties": {
+            "oneOf": [
+              {
+                "type": "string",
+                "maxLength": 4000
+              },
+              {
+                "type": "number"
+              },
+              {
+                "type": "boolean"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "description": "sharepoint.item.create / sharepoint.item.update (0.78.0): the item's column values keyed by the column's internal name (`Title`, `Status`, `DueDate`...), 1..32 of them; each a string of at most 4000 characters, a number, a boolean or null (which clears the column on an update). Which columns the list has, and whether a value fits its column type, is Graph's check."
+        },
+        "filter": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 512,
+          "description": "sharepoint.item.list (0.78.0): an OData `$filter` over the item's columns as `fields/<column> <op> <value>`, e.g. `fields/Status eq 'Open'`; absent lists every item. A filter on a column SharePoint has not indexed may be refused by Graph on a large list."
+        },
+        "conflict": {
+          "$ref": "#/definitions/SharePointConflictBehavior",
+          "description": "sharepoint.file.upload (0.78.0): what happens when a file of that name already exists in the folder; rename when absent."
+        },
+        "filename": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 255,
+          "description": "sharepoint.file.upload (0.78.0): the name the file is stored under (the result's `filename` is the stored name, which `conflict` rename may have changed)."
+        },
+        "contentType": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128,
+          "description": "sharepoint.file.upload (0.78.0): the file's MIME type, e.g. application/pdf."
+        },
+        "dataBase64": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 2796203,
+          "description": "sharepoint.file.upload (0.78.0): the file bytes, standard base64, at most 2 MiB of bytes (2,796,203 base64 characters) — the Gmail attachment bound."
+        },
         "columns": {
           "type": "array",
           "minItems": 1,
@@ -294,7 +365,7 @@
     "idempotencyKey": {
       "type": "string",
       "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
-      "description": "UUID of one explicit Send action; required for the sends (slack.message.post, slack.dm.send, gmail.message.send) and the receipted Basecamp writes (basecamp.todo.create, basecamp.message.post, basecamp.comment.post, basecamp.campfire.post; 0.76.0), refused everywhere else. The same key with the same payload and subject returns the recorded outcome for seven days."
+      "description": "UUID of one explicit Send action; required for the sends (slack.message.post, slack.dm.send, gmail.message.send), the receipted Basecamp writes (basecamp.todo.create, basecamp.message.post, basecamp.comment.post, basecamp.campfire.post; 0.76.0) and the receipted SharePoint writes (sharepoint.item.create, sharepoint.file.upload; 0.78.0), refused everywhere else. The same key with the same payload and subject returns the recorded outcome for seven days."
     },
     "mode": {
       "$ref": "app-integrations-declaration.schema.json#/definitions/IntegrationIdentityMode",
@@ -506,6 +577,292 @@
         }
       }
     },
+    {
+      "if": {
+        "properties": {
+          "operation": {
+            "const": "sharepoint.list.list"
+          }
+        }
+      },
+      "then": {
+        "x-read-only": true,
+        "x-primary-identity": "user",
+        "not": {
+          "required": [
+            "idempotencyKey"
+          ]
+        },
+        "properties": {
+          "mode": false,
+          "input": {
+            "propertyNames": {
+              "enum": [
+                "pageToken"
+              ]
+            }
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "operation": {
+            "const": "sharepoint.item.list"
+          }
+        }
+      },
+      "then": {
+        "x-read-only": true,
+        "x-primary-identity": "user",
+        "not": {
+          "required": [
+            "idempotencyKey"
+          ]
+        },
+        "properties": {
+          "mode": false,
+          "input": {
+            "propertyNames": {
+              "enum": [
+                "listId",
+                "filter",
+                "pageToken"
+              ]
+            },
+            "required": [
+              "listId"
+            ]
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "operation": {
+            "const": "sharepoint.item.create"
+          }
+        }
+      },
+      "then": {
+        "x-read-only": false,
+        "x-primary-identity": "user",
+        "required": [
+          "idempotencyKey"
+        ],
+        "properties": {
+          "mode": false,
+          "input": {
+            "propertyNames": {
+              "enum": [
+                "listId",
+                "fields"
+              ]
+            },
+            "required": [
+              "listId",
+              "fields"
+            ]
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "operation": {
+            "const": "sharepoint.item.update"
+          }
+        }
+      },
+      "then": {
+        "x-read-only": false,
+        "x-primary-identity": "user",
+        "not": {
+          "required": [
+            "idempotencyKey"
+          ]
+        },
+        "properties": {
+          "mode": false,
+          "input": {
+            "propertyNames": {
+              "enum": [
+                "listId",
+                "itemId",
+                "fields"
+              ]
+            },
+            "required": [
+              "listId",
+              "itemId",
+              "fields"
+            ]
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "operation": {
+            "const": "sharepoint.drive.list"
+          }
+        }
+      },
+      "then": {
+        "x-read-only": true,
+        "x-primary-identity": "user",
+        "not": {
+          "required": [
+            "idempotencyKey"
+          ]
+        },
+        "properties": {
+          "mode": false,
+          "input": {
+            "propertyNames": {
+              "enum": [
+                "pageToken"
+              ]
+            }
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "operation": {
+            "const": "sharepoint.file.list"
+          }
+        }
+      },
+      "then": {
+        "x-read-only": true,
+        "x-primary-identity": "user",
+        "not": {
+          "required": [
+            "idempotencyKey"
+          ]
+        },
+        "properties": {
+          "mode": false,
+          "input": {
+            "propertyNames": {
+              "enum": [
+                "driveId",
+                "folderId",
+                "pageToken"
+              ]
+            }
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "operation": {
+            "const": "sharepoint.file.search"
+          }
+        }
+      },
+      "then": {
+        "x-read-only": true,
+        "x-primary-identity": "user",
+        "not": {
+          "required": [
+            "idempotencyKey"
+          ]
+        },
+        "properties": {
+          "mode": false,
+          "input": {
+            "propertyNames": {
+              "enum": [
+                "q",
+                "driveId",
+                "pageToken"
+              ]
+            },
+            "required": [
+              "q"
+            ]
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "operation": {
+            "const": "sharepoint.file.read"
+          }
+        }
+      },
+      "then": {
+        "x-read-only": true,
+        "x-primary-identity": "user",
+        "not": {
+          "required": [
+            "idempotencyKey"
+          ]
+        },
+        "properties": {
+          "mode": false,
+          "input": {
+            "propertyNames": {
+              "enum": [
+                "fileId",
+                "driveId"
+              ]
+            },
+            "required": [
+              "fileId"
+            ]
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "operation": {
+            "const": "sharepoint.file.upload"
+          }
+        }
+      },
+      "then": {
+        "x-read-only": false,
+        "x-primary-identity": "user",
+        "required": [
+          "idempotencyKey"
+        ],
+        "properties": {
+          "mode": false,
+          "input": {
+            "propertyNames": {
+              "enum": [
+                "filename",
+                "contentType",
+                "dataBase64",
+                "driveId",
+                "folderId",
+                "conflict"
+              ]
+            },
+            "required": [
+              "filename",
+              "contentType",
+              "dataBase64"
+            ]
+          }
+        }
+      }
+    },
     {
       "if": {
         "properties": {
@@ -574,6 +931,9 @@
               "limit": {
                 "maximum": 50,
                 "default": 15
+              },
+              "pageToken": {
+                "maxLength": 256
               }
             }
           }
@@ -733,6 +1093,11 @@
                 "pageToken",
                 "projectStatus"
               ]
+            },
+            "properties": {
+              "pageToken": {
+                "maxLength": 256
+              }
             }
           }
         }
@@ -761,6 +1126,11 @@
               "enum": [
                 "pageToken"
               ]
+            },
+            "properties": {
+              "pageToken": {
+                "maxLength": 256
+              }
             }
           }
         }
@@ -794,7 +1164,12 @@
             },
             "required": [
               "todolistId"
-            ]
+            ],
+            "properties": {
+              "pageToken": {
+                "maxLength": 256
+              }
+            }
           }
         }
       }
@@ -894,6 +1269,11 @@
               "enum": [
                 "pageToken"
               ]
+            },
+            "properties": {
+              "pageToken": {
+                "maxLength": 256
+              }
             }
           }
         }
@@ -958,7 +1338,12 @@
             },
             "required": [
               "recordingId"
-            ]
+            ],
+            "properties": {
+              "pageToken": {
+                "maxLength": 256
+              }
+            }
           }
         }
       }
@@ -1058,6 +1443,11 @@
               "enum": [
                 "pageToken"
               ]
+            },
+            "properties": {
+              "pageToken": {
+                "maxLength": 256
+              }
             }
           }
         }
@@ -1149,6 +1539,16 @@
       ],
       "description": "Which projects basecamp.project.list returns (0.76.0): the active ones (the default) or the archived ones."
     },
+    "SharePointConflictBehavior": {
+      "type": "string",
+      "enum": [
+        "rename",
+        "replace",
+        "fail"
+      ],
+      "default": "rename",
+      "description": "What sharepoint.file.upload does when the folder already holds a file of that name (0.78.0; Graph's conflictBehavior): rename stores the new file under a numbered name (the default), replace overwrites the existing file, fail refuses the upload."
+    },
     "EmailAttachment": {
       "type": "object",
       "additionalProperties": false,
@@ -1703,6 +2103,96 @@
       "operation": "basecamp.people.list",
       "resource": "launch",
       "input": {}
+    },
+    {
+      "connection": "company-sharepoint",
+      "operation": "sharepoint.list.list",
+      "resource": "intranet",
+      "input": {}
+    },
+    {
+      "connection": "company-sharepoint",
+      "operation": "sharepoint.item.list",
+      "resource": "intranet",
+      "input": {
+        "listId": "c8f7a4d1-2b3e-4f5a-9c6d-7e8f9a0b1c2d",
+        "filter": "fields/Status eq 'Open'"
+      }
+    },
+    {
+      "connection": "company-sharepoint",
+      "operation": "sharepoint.item.create",
+      "resource": "intranet",
+      "input": {
+        "listId": "c8f7a4d1-2b3e-4f5a-9c6d-7e8f9a0b1c2d",
+        "fields": {
+          "Title": "Renew the office lease",
+          "Status": "Open",
+          "DueDate": "2026-10-31",
+          "Priority": 2,
+          "Urgent": false
+        }
+      },
+      "idempotencyKey": "6f1c2c1e-3a1c-4c3e-9f0e-2b6f7d8a9c20"
+    },
+    {
+      "connection": "company-sharepoint",
+      "operation": "sharepoint.item.update",
+      "resource": "intranet",
+      "input": {
+        "listId": "c8f7a4d1-2b3e-4f5a-9c6d-7e8f9a0b1c2d",
+        "itemId": "42",
+        "fields": {
+          "Status": "Done",
+          "DueDate": null
+        }
+      }
+    },
+    {
+      "connection": "company-sharepoint",
+      "operation": "sharepoint.drive.list",
+      "resource": "intranet",
+      "input": {}
+    },
+    {
+      "connection": "company-sharepoint",
+      "operation": "sharepoint.file.list",
+      "resource": "intranet",
+      "input": {
+        "driveId": "b!X1Y2Z3a4B5c6D7e8F9g0H1i2J3k4L5m6N7o8P9q0R1s2T3u4V5w6X7y8Z9a0B1c2",
+        "folderId": "01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36K"
+      }
+    },
+    {
+      "connection": "company-sharepoint",
+      "operation": "sharepoint.file.search",
+      "resource": "intranet",
+      "input": {
+        "q": "weekly report",
+        "pageToken": "UGFnZWQ9VFJVRSZwX1NvcnRCZWhhdmlvcj0xJnBfRmlsZUxlYWZSZWY9d2Vla2x5LXJlcG9ydC5wZGYmcF9JRD00Mg"
+      }
+    },
+    {
+      "connection": "company-sharepoint",
+      "operation": "sharepoint.file.read",
+      "resource": "intranet",
+      "input": {
+        "fileId": "01BYE5RZ5MYLM2SMX75ZBIPQZIHT6OAYPB",
+        "driveId": "b!X1Y2Z3a4B5c6D7e8F9g0H1i2J3k4L5m6N7o8P9q0R1s2T3u4V5w6X7y8Z9a0B1c2"
+      }
+    },
+    {
+      "connection": "company-sharepoint",
+      "operation": "sharepoint.file.upload",
+      "resource": "intranet",
+      "input": {
+        "filename": "weekly-report.pdf",
+        "contentType": "application/pdf",
+        "dataBase64": "JVBERi0xLjQKJcOkw7zDtsOfCg==",
+        "driveId": "b!X1Y2Z3a4B5c6D7e8F9g0H1i2J3k4L5m6N7o8P9q0R1s2T3u4V5w6X7y8Z9a0B1c2",
+        "conflict": "replace"
+      },
+      "idempotencyKey": "6f1c2c1e-3a1c-4c3e-9f0e-2b6f7d8a9c21"
     }
   ]
 }