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

generate-docs never read visibility, so every tool param appeared in the
public Input table -- including params marked visibility:'hidden', which are
shown to neither the user nor the LLM. Several are credential-shaped
(idToken, instanceUrl, apiToken, cloudId), so the docs told integrators they
could set values they cannot reach.

A hidden param is now dropped only when the block declares no subBlock for
it, matched on id or canonicalParamId -- a param can be hidden on the tool
because the block injects it while the block still renders it as a required
field the user types.

blankStringsAndComments kept the first and last character of every match.
That is right for a quoted string, where both are delimiters, but for a '//'
comment the last character is arbitrary source text, so a commented-out
'//   options: [' left an unbalanced bracket that derailed the subBlock
scan. Parsing now throws rather than silently reporting that a block
exposes nothing, since that fallback was the destructive one.

Also corrects the LinkedIn w_member_social consent-screen description, which
read 'Access LinkedIn profile' for a scope that posts on the user's behalf.

Author: waleedlatif1

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

@@ -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

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

@@ -44,7 +44,6 @@ Create a new booking on Cal.com
 | --------- | ---- | -------- | ----------- |
 | `eventTypeId` | number | Yes | The ID of the event type to book |
 | `start` | string | Yes | Start time in UTC ISO 8601 format \(e.g., 2024-01-15T09:00:00Z\) |
-| `attendee` | object | Yes | Attendee information object with name, email, timeZone, and optional phoneNumber \(constructed from individual attendee fields\) |
 | `guests` | array | No | Array of guest email addresses |
 | `lengthInMinutes` | number | No | Duration of the booking in minutes \(overrides event type default\) |
 | `metadata` | object | No | Custom metadata to attach to the booking |

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

@@ -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

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

@@ -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 |

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

@@ -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
@@ -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 |
 
@@ -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 |
 | `apiKey` | string | Yes | Firecrawl API key |
 
 #### Output
@@ -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 |
@@ -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
@@ -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

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

@@ -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

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

@@ -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
 
@@ -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
 
@@ -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
 

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

@@ -43,10 +43,8 @@ List files and folders in Google Drive with complete metadata
 | Parameter | Type | Required | Description |
 | --------- | ---- | -------- | ----------- |
 | `folderSelector` | string | No | Google Drive folder ID to list files from \(e.g., 1ABCxyz...\) |
-| `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
 
@@ -228,7 +226,6 @@ Create a new folder in Google Drive with complete metadata returned
 | --------- | ---- | -------- | ----------- |
 | `fileName` | string | Yes | Name of the folder to create |
 | `folderSelector` | string | No | Google Drive parent folder ID to create the folder in \(e.g., 1ABCxyz...\) |
-| `folderId` | string | No | ID of the parent folder \(internal use\) |
 
 #### Output
 
@@ -286,7 +283,6 @@ Upload a file to Google Drive with complete metadata returned
 | `content` | string | No | Text content to upload \(use this OR file, not both\) |
 | `mimeType` | string | No | The MIME type of the file to upload \(auto-detected from file if not provided\) |
 | `folderSelector` | string | No | Google Drive folder ID to upload the file to \(e.g., 1ABCxyz...\) |
-| `folderId` | string | No | The ID of the folder to upload the file to \(internal use\) |
 
 #### Output
 
@@ -485,7 +481,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
 
@@ -673,7 +668,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
 
@@ -723,7 +717,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
 
@@ -783,7 +776,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
 

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

@@ -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
 
@@ -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
 
@@ -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