fix(docs): abort before writing on a parse failure, unhang three descriptions

The guard's own TSDoc said to fail rather than guess, because the fallback
strips every hidden param from a page. The caller did the opposite: it
caught, recorded, and continued with an empty id set, and the non-zero exit
came after every page was already written. A developer who reran, saw red,
and missed the scrollback could commit a stripped page. Parse failures are
now detected in a dry pass before anything is emitted.

The zero-id guard also only fired when the array held a literal '{', so a
subBlocks built by a helper call was silently empty, while a subBlocks whose
literals only spread ({ ...sb, required: true }) hard-failed the build. It
now fires on the destructive case alone -- reporting an unreadable array
while leaving legitimate opaque spreads, which 23 blocks rely on, untouched.

Three descriptions referenced things the reader can no longer see: Dataverse
mandated base64 after its base64 row was removed, Vanta's mimeType described
itself as useful only on that removed path, and five Drive actions told the
reader to fetch a next page with no input left to accept the token.

Author: waleedlatif1

apps/docs/content/docs/en/integrations/google_drive.mdx

@@ -104,7 +104,7 @@ List files and folders in Google Drive with complete metadata
 |   ↳ `isAppAuthorized` | boolean | Whether created by requesting app |
 |   ↳ `contentRestrictions` | json | Content restrictions |
 |   ↳ `linkShareMetadata` | json | Link share metadata |
-| `nextPageToken` | string | Token for fetching the next page of results |
+| `nextPageToken` | string | Google Drive pagination cursor returned when more files remain beyond this response; empty when this is the last page |
 
 ### Get Google Drive File
 
@@ -516,7 +516,7 @@ Search for files in Google Drive using advanced query syntax (e.g., fullText con
 |   ↳ `driveId` | string | Shared drive ID |
 |   ↳ `capabilities` | json | User capabilities on file |
 |   ↳ `version` | string | Version number |
-| `nextPageToken` | string | Token for fetching the next page of results |
+| `nextPageToken` | string | Google Drive pagination cursor returned when more files remain beyond this response; empty when this is the last page |
 
 ### Update Google Drive File
 
@@ -689,7 +689,7 @@ List all permissions (who has access) for a file in Google Drive
 |   ↳ `allowFileDiscovery` | boolean | Whether file is discoverable by grantee |
 |   ↳ `pendingOwner` | boolean | Whether ownership transfer is pending |
 |   ↳ `permissionDetails` | json | Details about inherited permissions |
-| `nextPageToken` | string | Token for fetching the next page of permissions |
+| `nextPageToken` | string | Google Drive pagination cursor returned when more permissions remain beyond this response; empty when this is the last page |
 
 ### Export Google Drive File
 
@@ -737,7 +737,7 @@ List the revision history of a file in Google Drive
 |   ↳ `md5Checksum` | string | MD5 checksum for binary revisions |
 |   ↳ `size` | string | Size of the revision in bytes |
 |   ↳ `exportLinks` | json | Export format links for the revision |
-| `nextPageToken` | string | Token for fetching the next page of revisions |
+| `nextPageToken` | string | Google Drive pagination cursor returned when more revisions remain beyond this response; empty when this is the last page |
 
 ### Get Google Drive Revision
 
@@ -796,7 +796,7 @@ List comments on a file in Google Drive
 |   ↳ `anchor` | string | Region of the document the comment refers to |
 |   ↳ `quotedFileContent` | json | The file content the comment quotes |
 |   ↳ `replies` | json | Threaded replies to the comment |
-| `nextPageToken` | string | Token for fetching the next page of comments |
+| `nextPageToken` | string | Google Drive pagination cursor returned when more comments remain beyond this response; empty when this is the last page |
 
 ### Create Google Drive Comment
 

apps/docs/content/docs/en/integrations/microsoft_dataverse.mdx

@@ -387,7 +387,7 @@ Update an existing record in a Microsoft Dataverse table. Only send the columns
 
 ### Upload File to Microsoft Dataverse
 
-Upload a file to a file or image column on a Dataverse record. Supports single-request upload for files up to 128 MB. The file content must be provided as a base64-encoded string.
+Upload a file to a file or image column on a Dataverse record. Supports single-request upload for files up to 128 MB. Provide the file through the File input; its bytes are read from storage and sent to Dataverse directly.
 
 #### Input
 

apps/docs/content/docs/en/integrations/vanta.mdx

@@ -331,7 +331,7 @@ Upload an evidence file to a Vanta document. Requires credentials with the vanta
 | `documentId` | string | Yes | Unique ID of the document to attach the file to |
 | `file` | file | No | The evidence file to upload |
 | `fileName` | string | No | Optional file name override |
-| `mimeType` | string | No | MIME type of the file \(e.g., application/pdf\); used when uploading base64 content, since uploaded files already carry their own type |
+| `mimeType` | string | No | MIME type of the file \(e.g., application/pdf\); used only as a fallback when the uploaded file does not carry a content type of its own |
 | `description` | string | No | Description of the uploaded evidence \(e.g., "Q3 access review evidence"\) |
 | `effectiveAtDate` | string | No | ISO 8601 date indicating when the document is effective from |
 

apps/sim/tools/generated/tool-metadata.ts

@@ -198,7 +198,8 @@ export const listTool: ToolConfig<GoogleDriveToolParams, GoogleDriveListResponse
     },
     nextPageToken: {
       type: 'string',
-      description: 'Token for fetching the next page of results',
+      description:
+        'Google Drive pagination cursor returned when more files remain beyond this response; empty when this is the last page',
     },
   },
 }

apps/sim/tools/generated/tool-outputs.ts

@@ -134,7 +134,8 @@ export const listCommentsTool: ToolConfig<
     },
     nextPageToken: {
       type: 'string',
-      description: 'Token for fetching the next page of comments',
+      description:
+        'Google Drive pagination cursor returned when more comments remain beyond this response; empty when this is the last page',
     },
   },
 }

apps/sim/tools/google_drive/list.ts

@@ -134,7 +134,8 @@ export const listPermissionsTool: ToolConfig<
     },
     nextPageToken: {
       type: 'string',
-      description: 'Token for fetching the next page of permissions',
+      description:
+        'Google Drive pagination cursor returned when more permissions remain beyond this response; empty when this is the last page',
     },
   },
 }

apps/sim/tools/google_drive/list_comments.ts

@@ -120,7 +120,8 @@ export const listRevisionsTool: ToolConfig<
     },
     nextPageToken: {
       type: 'string',
-      description: 'Token for fetching the next page of revisions',
+      description:
+        'Google Drive pagination cursor returned when more revisions remain beyond this response; empty when this is the last page',
     },
   },
 }

apps/sim/tools/google_drive/list_permissions.ts

@@ -144,7 +144,8 @@ export const searchTool: ToolConfig<GoogleDriveSearchParams, GoogleDriveSearchRe
     },
     nextPageToken: {
       type: 'string',
-      description: 'Token for fetching the next page of results',
+      description:
+        'Google Drive pagination cursor returned when more files remain beyond this response; empty when this is the last page',
     },
   },
 }