Skip to content

fix(docs): stop publishing unsettable params, fix comment blanking #7169

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
waleedlatif1 merged 23 commits into from
Aug 28, 2026
Merged

fix(docs): stop publishing unsettable params, fix comment blanking #7169

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
23 commits
Select commit Hold shift + click to select a range
26e9556
fix(docs): stop publishing unsettable params, fix comment blanking
waleedlatif1 Aug 27, 2026
951561e
fix(docs): keep hidden params the block mapper supplies
waleedlatif1 Aug 27, 2026
d60aa92
fix(tools): reject values that cannot be a path segment
waleedlatif1 Aug 27, 2026
0a53bd9
test(oauth): pin the LinkedIn write-scope description
waleedlatif1 Aug 27, 2026
cb3a166
fix(docs): stop a comment hijacking the id scan, unhang a Firecrawl r…
waleedlatif1 Aug 27, 2026
3294481
refactor(tools): drop the unused guard API from this PR
waleedlatif1 Aug 27, 2026
bd817f6
fix(docs): abort before writing on a parse failure, unhang three desc…
waleedlatif1 Aug 27, 2026
4f1f4ea
chore(tinyfish): use a white block background
waleedlatif1 Aug 27, 2026
caf86a2
fix(docs): correct Drive/Firecrawl/Vanta output and param descriptions
waleedlatif1 Aug 27, 2026
4782daa
fix(docs): correct the Vanta mimeType and Firecrawl reachability wording
waleedlatif1 Aug 28, 2026
b13c7dc
fix(docs): never abort the generator on an unreadable subBlocks array
waleedlatif1 Aug 28, 2026
1db2430
fix(docs): name the input that gates Firecrawl search scrape output
waleedlatif1 Aug 28, 2026
3727ec9
fix(docs): say the Vanta mimeType is ignored for File-input uploads
waleedlatif1 Aug 28, 2026
3ede8d5
Merge remote-tracking branch 'origin/staging' into fix/docs-generator…
waleedlatif1 Aug 28, 2026
b8632d2
fix(docs): note the hidden inputs that gate Pulse html and figures ou…
waleedlatif1 Aug 28, 2026
8d828cc
Merge remote-tracking branch 'origin/staging' into fix/docs-generator…
waleedlatif1 Aug 28, 2026
102dbd6
fix(docs): report a spread-only subBlocks array as unknown, not empty
waleedlatif1 Aug 28, 2026
d817e09
fix(daytona): stop the lifecycle tools crashing on a non-string sandb…
waleedlatif1 Aug 28, 2026
1cb3f8f
docs(url-path): drop the false claim that widening restores prior beh…
waleedlatif1 Aug 28, 2026
ef17d5f
fix(docs): correct output rows that cite inputs Sim does not send
waleedlatif1 Aug 28, 2026
80c8bd4
Merge remote-tracking branch 'origin/staging' into fix/docs-generator…
waleedlatif1 Aug 28, 2026
ea967cf
style: wrap long description literals to satisfy biome
waleedlatif1 Aug 28, 2026
8dbebd0
fix(docs): cite the real Mistral options behind tables, header and fo…
waleedlatif1 Aug 28, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 0 additions & 1 deletion apps/docs/content/docs/en/integrations/box.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -52,7 +52,6 @@ Upload a file to a Box folder
| --------- | ---- | -------- | ----------- |
| `parentFolderId` | string | Yes | The ID of the folder to upload the file to \(use "0" for root\) |
| `file` | file | No | The file to upload \(UserFile object\) |
| `fileContent` | string | No | Legacy: base64 encoded file content |
| `fileName` | string | No | Optional filename override |

#### Output
Expand Down
1 change: 0 additions & 1 deletion apps/docs/content/docs/en/integrations/daytona.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -216,7 +216,6 @@ Upload a file to a Daytona sandbox
| `sandboxId` | string | Yes | ID of the sandbox to upload the file to |
| `destinationPath` | string | Yes | Destination path in the sandbox \(a trailing slash uploads into that directory using the file name\) |
| `file` | file | No | The file to upload |
| `fileContent` | string | No | Legacy: base64 encoded file content |
| `fileName` | string | No | Optional file name override |

#### Output
Expand Down
1 change: 0 additions & 1 deletion apps/docs/content/docs/en/integrations/dropbox.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,6 @@ Upload a file to Dropbox
| --------- | ---- | -------- | ----------- |
| `path` | string | Yes | The path in Dropbox where the file should be saved \(e.g., /folder/document.pdf\) |
| `file` | file | No | The file to upload \(UserFile object\) |
| `fileContent` | string | No | Legacy: base64 encoded file content |
| `fileName` | string | No | Optional filename \(used if path is a folder\) |
| `mode` | string | No | Write mode: add \(default\) or overwrite |
| `autorename` | boolean | No | If true, rename the file if there is a conflict |
Expand Down
16 changes: 5 additions & 11 deletions apps/docs/content/docs/en/integrations/firecrawl.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -52,7 +52,6 @@ Extract structured content from web pages with comprehensive metadata support. C
| --------- | ---- | -------- | ----------- |
| `url` | string | Yes | The URL to scrape content from \(e.g., "https://example.com/page"\) |
| `formats` | json | No | Output formats supplied by existing Firecrawl block configurations |
| `scrapeOptions` | json | No | Options for content scraping |
| `apiKey` | string | Yes | Firecrawl API key |

#### Output
Expand Down Expand Up @@ -90,7 +89,6 @@ Scrape multiple URLs in a single batch job and retrieve structured content from
| `onlyMainContent` | boolean | No | Extract only main content from pages |
| `maxConcurrency` | number | No | Maximum number of concurrent scrapes |
| `ignoreInvalidURLs` | boolean | No | Skip invalid URLs instead of failing the batch \(default: true\) |
| `scrapeOptions` | json | No | Advanced scraping configuration options |
| `zeroDataRetention` | boolean | No | Enable zero data retention |
| `apiKey` | string | Yes | Firecrawl API key |

Expand Down Expand Up @@ -159,7 +157,6 @@ Search for information on the web using Firecrawl
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `query` | string | Yes | The search query to use |
| `scrapeOptions` | json | No | Advanced scrape options supplied by existing configurations |
Comment thread
waleedlatif1 marked this conversation as resolved.
| `apiKey` | string | Yes | Firecrawl API key |

#### Output
Expand All @@ -170,11 +167,11 @@ Search for information on the web using Firecrawl
| ↳ `title` | string | Search result title from search engine |
| ↳ `description` | string | Search result description/snippet from search engine |
| ↳ `url` | string | URL of the search result |
| ↳ `markdown` | string | Page content in markdown \(when scrapeOptions.formats includes "markdown"\) |
| ↳ `html` | string | Processed HTML content \(when scrapeOptions.formats includes "html"\) |
| ↳ `rawHtml` | string | Unprocessed raw HTML \(when scrapeOptions.formats includes "rawHtml"\) |
| ↳ `links` | array | Links found on the page \(when scrapeOptions.formats includes "links"\) |
| ↳ `screenshot` | string | Screenshot URL \(expires after 24 hours, when scrapeOptions.formats includes "screenshot"\) |
| ↳ `markdown` | string | Page content in markdown; returned only when scraping was requested via the hidden scrapeOptions input |
| ↳ `html` | string | Processed HTML content; returned only when "html" is among the scrape formats requested via the hidden scrapeOptions input |
| ↳ `rawHtml` | string | Unprocessed raw HTML; returned only when "rawHtml" is among the scrape formats requested via the hidden scrapeOptions input |
| ↳ `links` | array | Links found on the page; returned only when "links" is among the scrape formats requested via the hidden scrapeOptions input |
| ↳ `screenshot` | string | Screenshot URL \(expires after 24 hours\); returned only when "screenshot" is among the scrape formats requested via the hidden scrapeOptions input |
| ↳ `metadata` | object | Metadata about the search result page |
| ↳ `title` | string | Page title |
| ↳ `description` | string | Page meta description |
Expand All @@ -195,7 +192,6 @@ Crawl entire websites and extract structured content from all accessible pages
| `maxDepth` | number | No | Maximum depth to crawl from the starting URL \(e.g., 1, 2, 3\). Controls how many levels deep to follow links |
| `formats` | json | No | Output formats for scraped content \(e.g., \["markdown"\], \["markdown", "html"\], \["markdown", "links"\]\) |
| `prompt` | string | No | Natural-language crawl guidance supplied by existing configurations |
| `scrapeOptions` | json | No | Advanced scrape options supplied by existing configurations |
| `excludePaths` | json | No | URL paths to exclude from crawling \(e.g., \["/blog/*", "/admin/*", "/*.pdf"\]\) |
| `includePaths` | json | No | URL paths to include in crawling \(e.g., \["/docs/*", "/api/*"\]\). Only these paths will be crawled |
| `onlyMainContent` | boolean | No | Extract only main content from pages |
Expand Down Expand Up @@ -287,7 +283,6 @@ Get a complete list of URLs from any website quickly and reliably. Useful for di
| `ignoreQueryParameters` | boolean | No | Exclude URLs containing query strings \(default: true\) |
| `limit` | number | No | Maximum number of links to return \(e.g., 100, 1000, 5000\). Max: 100,000, default: 5,000 |
| `timeout` | number | No | Request timeout in milliseconds |
| `location` | json | No | Geographic context for proxying \(country, languages\) |
| `apiKey` | string | Yes | Firecrawl API key |

#### Output
Expand All @@ -313,7 +308,6 @@ Extract structured data from entire webpages using natural language prompts and
| `includeSubdomains` | boolean | No | Extend scanning to subdomains \(default: true\) |
| `showSources` | boolean | No | Return data sources in the response \(default: false\) |
| `ignoreInvalidURLs` | boolean | No | Skip invalid URLs in the array \(default: true\) |
| `scrapeOptions` | json | No | Advanced scraping configuration options |
| `apiKey` | string | Yes | Firecrawl API key |

#### Output
Expand Down
3 changes: 0 additions & 3 deletions apps/docs/content/docs/en/integrations/github.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -120,11 +120,8 @@ Create comments on GitHub PRs
| `body` | string | Yes | Comment content |
| `pullNumber` | number | Yes | Pull request number |
| `path` | string | No | File path for review comment |
| `position` | number | No | Line number for review comment |
| `commentType` | string | No | Type of comment \(pr_comment or file_comment\) |
| `line` | number | No | Line number for review comment |
| `side` | string | No | Side of the diff \(LEFT or RIGHT\) |
| `commitId` | string | No | The SHA of the commit to comment on |
| `apiKey` | string | Yes | GitHub API token |

#### Output
Expand Down
4 changes: 0 additions & 4 deletions apps/docs/content/docs/en/integrations/google_calendar.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -89,7 +89,6 @@ List events from Google Calendar. Returns API-aligned fields only.
| `maxResults` | number | No | Maximum number of events to return \(max 2500\) |
| `pageToken` | string | No | Token for retrieving the next page of results |
| `orderBy` | string | No | Order of events: startTime \(chronological, the default\) or updated \(last-modified\). startTime is always valid here because singleEvents is set. |
| `showDeleted` | boolean | No | Include deleted events |

#### Output

Expand Down Expand Up @@ -227,7 +226,6 @@ Get instances of a recurring event from Google Calendar. Returns API-aligned fie
| `timeMax` | string | No | Upper bound for instances \(RFC3339 timestamp, e.g., 2025-06-04T00:00:00Z\) |
| `maxResults` | number | No | Maximum number of instances to return \(default 250, max 2500\) |
| `pageToken` | string | No | Token for retrieving subsequent pages of results |
| `showDeleted` | boolean | No | Include deleted instances |

#### Output

Expand All @@ -248,8 +246,6 @@ List all calendars in the user's calendar list. Returns API-aligned fields only.
| `minAccessRole` | string | No | Minimum access role for returned calendars: freeBusyReader, reader, writer, or owner |
| `maxResults` | number | No | Maximum number of calendars to return \(default 100, max 250\) |
| `pageToken` | string | No | Token for retrieving subsequent pages of results |
| `showDeleted` | boolean | No | Include deleted calendars |
| `showHidden` | boolean | No | Include hidden calendars |

#### Output

Expand Down
15 changes: 5 additions & 10 deletions apps/docs/content/docs/en/integrations/google_drive.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,6 @@ List files and folders in Google Drive with complete metadata
| `folderId` | string | No | The ID of the folder to list files from \(internal use\) |
| `query` | string | No | Search term to filter files by name \(e.g. "budget" finds files with "budget" in the name\). Do NOT use Google Drive query syntax here - just provide a plain search term. |
| `pageSize` | number | No | The maximum number of files to return \(default: 100\) |
| `pageToken` | string | No | The page token to use for pagination |

#### Output

Expand Down Expand Up @@ -105,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 | Page token for the next page of files; absent from the response when the end of the files list has been reached |

### Get Google Drive File

Expand Down Expand Up @@ -485,7 +484,6 @@ Search for files in Google Drive using advanced query syntax (e.g., fullText con
| --------- | ---- | -------- | ----------- |
| `query` | string | Yes | Google Drive query string using advanced search syntax \(e.g., "fullText contains 'budget'", "mimeType = 'application/pdf'", "modifiedTime > '2024-01-01'"\) |
| `pageSize` | number | No | Maximum number of files to return \(default: 100\) |
| `pageToken` | string | No | Token for fetching the next page of results |

#### Output

Expand Down Expand Up @@ -518,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 | Page token for the next page of files; absent from the response when the end of the files list has been reached |

### Update Google Drive File

Expand Down Expand Up @@ -673,7 +671,6 @@ List all permissions (who has access) for a file in Google Drive
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `fileId` | string | Yes | The ID of the file to list permissions for |
| `pageToken` | string | No | The page token to use for pagination |

#### Output

Expand All @@ -692,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 | Page token for the next page of permissions; absent from the response when the end of the permissions list has been reached |

### Export Google Drive File

Expand Down Expand Up @@ -723,7 +720,6 @@ List the revision history of a file in Google Drive
| --------- | ---- | -------- | ----------- |
| `fileId` | string | Yes | The ID of the file to list revisions for |
| `pageSize` | number | No | Maximum number of revisions to return \(1-1000, default 200\) |
| `pageToken` | string | No | The page token to use for pagination |

#### Output

Expand All @@ -741,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 | Page token for the next page of revisions; absent from the response when the end of the revisions list has been reached |

### Get Google Drive Revision

Expand Down Expand Up @@ -783,7 +779,6 @@ List comments on a file in Google Drive
| `includeDeleted` | boolean | No | Whether to include deleted comments \(their content is stripped\) |
| `pageSize` | number | No | Maximum number of comments to return \(1-100, default 20\) |
| `startModifiedTime` | string | No | Only return comments modified after this RFC 3339 timestamp |
| `pageToken` | string | No | The page token to use for pagination |

#### Output

Expand All @@ -801,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 | Page token for the next page of comments; absent from the response when the end of the comments list has been reached |

### Create Google Drive Comment

Expand Down
3 changes: 0 additions & 3 deletions apps/docs/content/docs/en/integrations/google_sheets.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -75,7 +75,6 @@ Write data to a specific sheet in a Google Sheets spreadsheet
| `cellRange` | string | No | The cell range to write to \(e.g. "A1:D10", "A1"\). Defaults to "A1" if not specified. |
| `values` | array | Yes | The data to write as a 2D array \(e.g. \[\["Name", "Age"\], \["Alice", 30\], \["Bob", 25\]\]\) or array of objects. |
| `valueInputOption` | string | No | The format of the data to write |
| `includeValuesInResponse` | boolean | No | Whether to include the written values in the response |

#### Output

Expand All @@ -102,7 +101,6 @@ Update data in a specific sheet in a Google Sheets spreadsheet
| `cellRange` | string | No | The cell range to update \(e.g. "A1:D10", "A1"\). Defaults to "A1" if not specified. |
| `values` | array | Yes | The data to update as a 2D array \(e.g. \[\["Name", "Age"\], \["Alice", 30\]\]\) or array of objects. |
| `valueInputOption` | string | No | The format of the data to update |
| `includeValuesInResponse` | boolean | No | Whether to include the updated values in the response |

#### Output

Expand All @@ -129,7 +127,6 @@ Append data to the end of a specific sheet in a Google Sheets spreadsheet
| `values` | array | Yes | The data to append as a 2D array \(e.g. \[\["Alice", 30\], \["Bob", 25\]\]\) or array of objects. |
| `valueInputOption` | string | No | The format of the data to append |
| `insertDataOption` | string | No | How to insert the data \(OVERWRITE or INSERT_ROWS\) |
| `includeValuesInResponse` | boolean | No | Whether to include the appended values in the response |

#### Output

Expand Down
Loading
Loading