Skip to content

Commit caf86a2

Browse files
committed
fix(docs): correct Drive/Firecrawl/Vanta output and param descriptions
Google Drive nextPageToken: the discovery doc says the field is *absent* at the end of the list, not empty. Say absent, and name the resource (files/comments/permissions/revisions) per tool. Firecrawl search outputs: restore the per-format gate the v2 OpenAPI states ("HTML content if requested in formats"), and add that Search exposes no input for those formats. Vanta mimeType: the route resolves a content type from storage on every path, so the param is never read. Say so instead of describing it as a fallback. Dataverse: describe the request as sending the bytes as the raw body.
1 parent 4f1f4ea commit caf86a2

15 files changed

Lines changed: 27 additions & 27 deletions

File tree

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

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -167,11 +167,11 @@ Search for information on the web using Firecrawl
167167
|`title` | string | Search result title from search engine |
168168
|`description` | string | Search result description/snippet from search engine |
169169
|`url` | string | URL of the search result |
170-
|`markdown` | string | Page content in markdown, present only when the search result includes scraped page content |
171-
|`html` | string | Processed HTML content, present only when the search result includes scraped page content |
172-
|`rawHtml` | string | Unprocessed raw HTML, present only when the search result includes scraped page content |
173-
|`links` | array | Links found on the page, present only when the search result includes scraped page content |
174-
|`screenshot` | string | Screenshot URL \(expires after 24 hours\), present only when the search result includes a page screenshot |
170+
|`markdown` | string | Page content in markdown; returned only when scraping was requested, for which the Search operation exposes no input |
171+
|`html` | string | Processed HTML content; returned only when "html" is among the requested scrape formats, for which the Search operation exposes no input |
172+
|`rawHtml` | string | Unprocessed raw HTML; returned only when "rawHtml" is among the requested scrape formats, for which the Search operation exposes no input |
173+
|`links` | array | Links found on the page; returned only when "links" is among the requested scrape formats, for which the Search operation exposes no input |
174+
|`screenshot` | string | Screenshot URL \(expires after 24 hours\); returned only when "screenshot" is among the requested scrape formats, for which the Search operation exposes no input |
175175
|`metadata` | object | Metadata about the search result page |
176176
|`title` | string | Page title |
177177
|`description` | string | Page meta description |

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

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -104,7 +104,7 @@ List files and folders in Google Drive with complete metadata
104104
|`isAppAuthorized` | boolean | Whether created by requesting app |
105105
|`contentRestrictions` | json | Content restrictions |
106106
|`linkShareMetadata` | json | Link share metadata |
107-
| `nextPageToken` | string | Google Drive pagination cursor returned when more files remain beyond this response; empty when this is the last page |
107+
| `nextPageToken` | string | Page token for the next page of files; absent from the response when the end of the files list has been reached |
108108

109109
### Get Google Drive File
110110

@@ -516,7 +516,7 @@ Search for files in Google Drive using advanced query syntax (e.g., fullText con
516516
|`driveId` | string | Shared drive ID |
517517
|`capabilities` | json | User capabilities on file |
518518
|`version` | string | Version number |
519-
| `nextPageToken` | string | Google Drive pagination cursor returned when more files remain beyond this response; empty when this is the last page |
519+
| `nextPageToken` | string | Page token for the next page of files; absent from the response when the end of the files list has been reached |
520520

521521
### Update Google Drive File
522522

@@ -689,7 +689,7 @@ List all permissions (who has access) for a file in Google Drive
689689
|`allowFileDiscovery` | boolean | Whether file is discoverable by grantee |
690690
|`pendingOwner` | boolean | Whether ownership transfer is pending |
691691
|`permissionDetails` | json | Details about inherited permissions |
692-
| `nextPageToken` | string | Google Drive pagination cursor returned when more permissions remain beyond this response; empty when this is the last page |
692+
| `nextPageToken` | string | Page token for the next page of permissions; absent from the response when the end of the permissions list has been reached |
693693

694694
### Export Google Drive File
695695

@@ -737,7 +737,7 @@ List the revision history of a file in Google Drive
737737
|`md5Checksum` | string | MD5 checksum for binary revisions |
738738
|`size` | string | Size of the revision in bytes |
739739
|`exportLinks` | json | Export format links for the revision |
740-
| `nextPageToken` | string | Google Drive pagination cursor returned when more revisions remain beyond this response; empty when this is the last page |
740+
| `nextPageToken` | string | Page token for the next page of revisions; absent from the response when the end of the revisions list has been reached |
741741

742742
### Get Google Drive Revision
743743

@@ -796,7 +796,7 @@ List comments on a file in Google Drive
796796
|`anchor` | string | Region of the document the comment refers to |
797797
|`quotedFileContent` | json | The file content the comment quotes |
798798
|`replies` | json | Threaded replies to the comment |
799-
| `nextPageToken` | string | Google Drive pagination cursor returned when more comments remain beyond this response; empty when this is the last page |
799+
| `nextPageToken` | string | Page token for the next page of comments; absent from the response when the end of the comments list has been reached |
800800

801801
### Create Google Drive Comment
802802

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -387,7 +387,7 @@ Update an existing record in a Microsoft Dataverse table. Only send the columns
387387

388388
### Upload File to Microsoft Dataverse
389389

390-
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.
390+
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 as the raw request body.
391391

392392
#### Input
393393

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -331,7 +331,7 @@ Upload an evidence file to a Vanta document. Requires credentials with the vanta
331331
| `documentId` | string | Yes | Unique ID of the document to attach the file to |
332332
| `file` | file | No | The evidence file to upload |
333333
| `fileName` | string | No | Optional file name override |
334-
| `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 |
334+
| `mimeType` | string | No | MIME type of the file \(e.g., application/pdf\). Not currently applied: a file uploaded through the File input always sends the content type resolved from storage. |
335335
| `description` | string | No | Description of the uploaded evidence \(e.g., "Q3 access review evidence"\) |
336336
| `effectiveAtDate` | string | No | ISO 8601 date indicating when the document is effective from |
337337

apps/sim/tools/firecrawl/types.ts

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -136,32 +136,32 @@ export const SEARCH_RESULT_OUTPUT_PROPERTIES = {
136136
markdown: {
137137
type: 'string',
138138
description:
139-
'Page content in markdown, present only when the search result includes scraped page content',
139+
'Page content in markdown; returned only when scraping was requested, for which the Search operation exposes no input',
140140
optional: true,
141141
},
142142
html: {
143143
type: 'string',
144144
description:
145-
'Processed HTML content, present only when the search result includes scraped page content',
145+
'Processed HTML content; returned only when "html" is among the requested scrape formats, for which the Search operation exposes no input',
146146
optional: true,
147147
},
148148
rawHtml: {
149149
type: 'string',
150150
description:
151-
'Unprocessed raw HTML, present only when the search result includes scraped page content',
151+
'Unprocessed raw HTML; returned only when "rawHtml" is among the requested scrape formats, for which the Search operation exposes no input',
152152
optional: true,
153153
},
154154
links: {
155155
type: 'array',
156156
description:
157-
'Links found on the page, present only when the search result includes scraped page content',
157+
'Links found on the page; returned only when "links" is among the requested scrape formats, for which the Search operation exposes no input',
158158
optional: true,
159159
items: { type: 'string', description: 'URL found on the page' },
160160
},
161161
screenshot: {
162162
type: 'string',
163163
description:
164-
'Screenshot URL (expires after 24 hours), present only when the search result includes a page screenshot',
164+
'Screenshot URL (expires after 24 hours); returned only when "screenshot" is among the requested scrape formats, for which the Search operation exposes no input',
165165
optional: true,
166166
},
167167
metadata: SEARCH_METADATA_OUTPUT,

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

Lines changed: 1 addition & 1 deletion
Large diffs are not rendered by default.

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

Lines changed: 1 addition & 1 deletion
Large diffs are not rendered by default.

apps/sim/tools/google_drive/list.ts

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -199,7 +199,7 @@ export const listTool: ToolConfig<GoogleDriveToolParams, GoogleDriveListResponse
199199
nextPageToken: {
200200
type: 'string',
201201
description:
202-
'Google Drive pagination cursor returned when more files remain beyond this response; empty when this is the last page',
202+
'Page token for the next page of files; absent from the response when the end of the files list has been reached',
203203
},
204204
},
205205
}

apps/sim/tools/google_drive/list_comments.ts

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -135,7 +135,7 @@ export const listCommentsTool: ToolConfig<
135135
nextPageToken: {
136136
type: 'string',
137137
description:
138-
'Google Drive pagination cursor returned when more comments remain beyond this response; empty when this is the last page',
138+
'Page token for the next page of comments; absent from the response when the end of the comments list has been reached',
139139
},
140140
},
141141
}

apps/sim/tools/google_drive/list_permissions.ts

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -135,7 +135,7 @@ export const listPermissionsTool: ToolConfig<
135135
nextPageToken: {
136136
type: 'string',
137137
description:
138-
'Google Drive pagination cursor returned when more permissions remain beyond this response; empty when this is the last page',
138+
'Page token for the next page of permissions; absent from the response when the end of the permissions list has been reached',
139139
},
140140
},
141141
}

0 commit comments

Comments
 (0)