fix(docs): keep hidden params the block mapper supplies

The carve-out only recognized an identity match between a subBlock id and a
tool param, so a block that renames or assembles the value in
tools.config.params was invisible to it -- and the row was dropped even
though the user types it.

Cal.com's attendee (required) is assembled from attendeeName/attendeeEmail/
attendeeTimeZone; JSM's workspaceId comes from assetWorkspaceId; Textract
writes parameters.file from a field whose canonicalParamId is 'document',
which left the Mistral PDF Parser documenting zero inputs.

Collects params written by any accumulator identifier, not just 'result',
since the two real mappers use different names. Object keys are collected
without proving they are top-level, so a nested key can produce a false
keep -- one hard-to-set row is better than hiding a required input.

Author: waleedlatif1

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

@@ -44,6 +44,7 @@ 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/google_drive.mdx

@@ -43,6 +43,7 @@ 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\) |
 
@@ -226,6 +227,7 @@ 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
 
@@ -283,6 +285,7 @@ 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
 

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

@@ -963,6 +963,7 @@ List Assets (Insight/CMDB) object schemas in Jira Service Management
 | Parameter | Type | Required | Description |
 | --------- | ---- | -------- | ----------- |
 | `domain` | string | Yes | Your Jira domain \(e.g., yourcompany.atlassian.net\) |
+| `workspaceId` | string | No | Assets workspace ID \(resolved automatically when omitted\) |
 | `startAt` | number | No | Pagination start index \(e.g., 0, 50\) |
 | `maxResults` | number | No | Maximum schemas to return \(e.g., 25, 50\) |
 | `includeCounts` | boolean | No | Include object and object-type counts per schema |
@@ -992,6 +993,7 @@ Get a single Assets (Insight/CMDB) object schema by ID
 | Parameter | Type | Required | Description |
 | --------- | ---- | -------- | ----------- |
 | `domain` | string | Yes | Your Jira domain \(e.g., yourcompany.atlassian.net\) |
+| `workspaceId` | string | No | Assets workspace ID \(resolved automatically when omitted\) |
 | `schemaId` | string | Yes | The Assets object schema ID |
 
 #### Output
@@ -1017,6 +1019,7 @@ List object types within an Assets (Insight/CMDB) object schema
 | Parameter | Type | Required | Description |
 | --------- | ---- | -------- | ----------- |
 | `domain` | string | Yes | Your Jira domain \(e.g., yourcompany.atlassian.net\) |
+| `workspaceId` | string | No | Assets workspace ID \(resolved automatically when omitted\) |
 | `schemaId` | string | Yes | The Assets object schema ID to list object types for |
 | `excludeAbstract` | boolean | No | Exclude abstract object types from the result |
 
@@ -1044,6 +1047,7 @@ Get the attribute definitions for an Assets (Insight/CMDB) object type. Use the
 | Parameter | Type | Required | Description |
 | --------- | ---- | -------- | ----------- |
 | `domain` | string | Yes | Your Jira domain \(e.g., yourcompany.atlassian.net\) |
+| `workspaceId` | string | No | Assets workspace ID \(resolved automatically when omitted\) |
 | `objectTypeId` | string | Yes | The Assets object type ID |
 | `onlyValueEditable` | boolean | No | Return only attributes whose values can be edited |
 | `query` | string | No | Filter attributes by a search query |
@@ -1074,6 +1078,7 @@ Search Assets (Insight/CMDB) objects using AQL (Assets Query Language), e.g. obj
 | Parameter | Type | Required | Description |
 | --------- | ---- | -------- | ----------- |
 | `domain` | string | Yes | Your Jira domain \(e.g., yourcompany.atlassian.net\) |
+| `workspaceId` | string | No | Assets workspace ID \(resolved automatically when omitted\) |
 | `qlQuery` | string | Yes | AQL query string \(e.g., objectType = "Host" AND "Operating System" = "Ubuntu"\) |
 | `page` | number | No | Page number \(1-based, defaults to 1\) |
 | `resultsPerPage` | number | No | Results per page \(e.g., 25, 50\) |
@@ -1105,6 +1110,7 @@ Get a single Assets (Insight/CMDB) object by ID, including its attribute values
 | Parameter | Type | Required | Description |
 | --------- | ---- | -------- | ----------- |
 | `domain` | string | Yes | Your Jira domain \(e.g., yourcompany.atlassian.net\) |
+| `workspaceId` | string | No | Assets workspace ID \(resolved automatically when omitted\) |
 | `objectId` | string | Yes | The Assets object ID |
 
 #### Output
@@ -1133,6 +1139,7 @@ Create an Assets (Insight/CMDB) object of a given object type. Attributes use ob
 | Parameter | Type | Required | Description |
 | --------- | ---- | -------- | ----------- |
 | `domain` | string | Yes | Your Jira domain \(e.g., yourcompany.atlassian.net\) |
+| `workspaceId` | string | No | Assets workspace ID \(resolved automatically when omitted\) |
 | `objectTypeId` | string | Yes | The object type ID to create the object under |
 | `attributes` | json | Yes | Array of attributes: \[\{ objectTypeAttributeId, objectAttributeValues: \[\{ value \}\] \}\] |
 
@@ -1162,6 +1169,7 @@ Update an existing Assets (Insight/CMDB) object. Provide the attributes to chang
 | Parameter | Type | Required | Description |
 | --------- | ---- | -------- | ----------- |
 | `domain` | string | Yes | Your Jira domain \(e.g., yourcompany.atlassian.net\) |
+| `workspaceId` | string | No | Assets workspace ID \(resolved automatically when omitted\) |
 | `objectId` | string | Yes | The Assets object ID to update |
 | `attributes` | json | Yes | Array of attributes to set: \[\{ objectTypeAttributeId, objectAttributeValues: \[\{ value \}\] \}\] |
 | `objectTypeId` | string | No | Optional object type ID \(only if changing the type\) |
@@ -1192,6 +1200,7 @@ Delete an Assets (Insight/CMDB) object by ID
 | Parameter | Type | Required | Description |
 | --------- | ---- | -------- | ----------- |
 | `domain` | string | Yes | Your Jira domain \(e.g., yourcompany.atlassian.net\) |
+| `workspaceId` | string | No | Assets workspace ID \(resolved automatically when omitted\) |
 | `objectId` | string | Yes | The Assets object ID to delete |
 
 #### Output

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

@@ -39,6 +39,7 @@ Integrate Mistral Parse into the workflow. Can extract text from uploaded PDF do
 
 | Parameter | Type | Required | Description |
 | --------- | ---- | -------- | ----------- |
+| `file` | file | Yes | Normalized UserFile from file upload or file reference |
 
 #### Output
 

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

@@ -39,6 +39,7 @@ Integrate AWS Textract into your workflow to extract text, tables, forms, and ke
 
 | Parameter | Type | Required | Description |
 | --------- | ---- | -------- | ----------- |
+| `file` | file | No | Document to be processed \(JPEG, PNG, or single-page PDF\). |
 
 #### Output
 
@@ -89,6 +90,7 @@ Extract structured invoice and receipt fields using AWS Textract AnalyzeExpense
 | `secretAccessKey` | string | Yes | AWS Secret Access Key |
 | `region` | string | Yes | AWS region for Textract service \(e.g., us-east-1\) |
 | `processingMode` | string | No | Document type: single-page or multi-page. Defaults to single-page. |
+| `file` | file | No | Invoice or receipt to be processed \(JPEG, PNG, or single-page PDF\). |
 | `filePath` | string | No | URL to an invoice or receipt to be processed, if not uploaded directly. |
 | `s3Uri` | string | No | S3 URI for multi-page processing \(s3://bucket/key\). |
 
@@ -118,7 +120,10 @@ Extract identity document fields using AWS Textract AnalyzeID
 | `accessKeyId` | string | Yes | AWS Access Key ID |
 | `secretAccessKey` | string | Yes | AWS Secret Access Key |
 | `region` | string | Yes | AWS region for Textract service \(e.g., us-east-1\) |
+| `file` | file | No | Front of the identity document \(JPEG, PNG, or PDF\). |
 | `filePath` | string | No | URL to the front of the identity document, if not uploaded directly. |
+| `fileBack` | file | No | Back of the identity document, if applicable \(JPEG, PNG, or PDF\). |
+| `filePathBack` | string | No | URL to the back of the identity document, if not uploaded directly. |
 
 #### Output
 

scripts/generate-docs.test.ts

@@ -2,6 +2,7 @@ import fs from 'fs'
 import path from 'path'
 import { describe, expect, it } from 'vitest'
 import {
+  extractBlockSuppliedParamIds,
   extractUserSettableParamIds,
   getToolInfo,
   parseConstProperties,
@@ -165,3 +166,85 @@ describe('subBlock param extraction', () => {
     )
   })
 })
+
+describe('hidden params supplied by the block mapper', () => {
+  const blockSource = (blockFile: string) =>
+    fs.readFileSync(path.join(import.meta.dirname, '../apps/sim/blocks/blocks', blockFile), 'utf-8')
+
+  const paramNames = async (toolId: string, blockFile: string) => {
+    const info = await getToolInfo(toolId, extractBlockSuppliedParamIds(blockSource(blockFile)))
+    return info?.params.map((param) => param.name) ?? []
+  }
+
+  it("keeps Cal.com's required attendee, assembled as result.attendee in the mapper", async () => {
+    expect(extractBlockSuppliedParamIds(blockSource('calcom.ts'))).toContain('attendee')
+    await expect(paramNames('calcom_create_booking', 'calcom.ts')).resolves.toContain('attendee')
+  })
+
+  it("keeps JSM's workspaceId, renamed from assetWorkspaceId in the mapper", async () => {
+    expect(extractBlockSuppliedParamIds(blockSource('jira_service_management.ts'))).toContain(
+      'workspaceId'
+    )
+    await expect(
+      paramNames('jsm_list_object_schemas', 'jira_service_management.ts')
+    ).resolves.toContain('workspaceId')
+  })
+
+  it('keeps the file params Textract renames from its document field', async () => {
+    const ids = extractBlockSuppliedParamIds(blockSource('textract.ts'))
+    expect(ids).toContain('file')
+    expect(ids).toContain('fileBack')
+    expect(ids).toContain('filePathBack')
+
+    const params = await paramNames('textract_analyze_id', 'textract.ts')
+    expect(params).toContain('file')
+    expect(params).toContain('fileBack')
+    expect(params).toContain('filePathBack')
+  })
+
+  it('keeps the Mistral parser file param, so its Input table is not empty', async () => {
+    await expect(paramNames('mistral_parser_v3', 'mistral_parse.ts')).resolves.toContain('file')
+  })
+
+  it('still drops resolver-derived hidden params with no user surface', async () => {
+    await expect(paramNames('jira_retrieve', 'jira.ts')).resolves.not.toContain('cloudId')
+    await expect(
+      paramNames('jsm_list_object_schemas', 'jira_service_management.ts')
+    ).resolves.not.toContain('cloudId')
+
+    const salesforce = await paramNames('salesforce_query', 'salesforce.ts')
+    expect(salesforce).not.toContain('idToken')
+    expect(salesforce).not.toContain('instanceUrl')
+
+    await expect(paramNames('netsuite_execute_suiteql', 'netsuite.ts')).resolves.not.toContain(
+      'instanceUrl'
+    )
+    await expect(paramNames('snowflake_execute_sql', 'snowflake.ts')).resolves.not.toContain(
+      'domain'
+    )
+    await expect(paramNames('pipedrive_get_deal', 'pipedrive.ts')).resolves.not.toContain(
+      'authStyle'
+    )
+    await expect(paramNames('zoho_desk_list_tickets', 'zoho-desk.ts')).resolves.not.toContain(
+      'apiDomain'
+    )
+  })
+
+  it('ignores a commented-out mapper assignment', () => {
+    const ids = extractBlockSuppliedParamIds(`
+      subBlocks: [{ id: 'operation' }],
+      tools: {
+        config: {
+          params: (params) => {
+            const result: Record<string, unknown> = {}
+            // result.commentedOut = params.nope
+            result.realOne = params.yes
+            return result
+          },
+        },
+      },
+    `)
+    expect(ids).toContain('realOne')
+    expect(ids).not.toContain('commentedOut')
+  })
+})

scripts/generate-docs.ts

@@ -200,7 +200,10 @@ interface BlockConfig {
     access?: string[]
   }
   operations?: OperationInfo[]
-  /** Param names the block exposes to the user via its own `subBlocks` (id or `canonicalParamId`). */
+  /**
+   * Param names the block itself supplies — via a `subBlocks` field (id or
+   * `canonicalParamId`) or via its `tools.config.params` mapper.
+   */
   userSettableParamIds?: string[]
   docsLink?: string
   [key: string]: any
@@ -735,6 +738,116 @@ export function extractUserSettableParamIds(blockContent: string, blockName = 'b
   return [...ids]
 }
 
+/**
+ * Locates the bodies of every `tools.config.params` mapper in `scannable`.
+ *
+ * Returns `[start, end)` index pairs into `scannable` (a length-preserving blanked copy, so
+ * the same indices address the original content). A file can hold several block configs
+ * (Textract ships a v1 and a v2 block), so every `tools` object is scanned rather than only
+ * the first. Handles both `params: (params) => { ... }` and the concise
+ * `params: (params) => ({ ... })` form.
+ */
+function findMapperBodyRanges(scannable: string): [number, number][] {
+  const ranges: [number, number][] = []
+  const toolsRegex = /\btools\s*:\s*\{/g
+  let toolsMatch: RegExpExecArray | null
+
+  while ((toolsMatch = toolsRegex.exec(scannable)) !== null) {
+    const toolsEnd = findMatchingClose(scannable, toolsMatch.index + toolsMatch[0].length - 1)
+    if (toolsEnd === -1) continue
+    toolsRegex.lastIndex = toolsEnd
+
+    const toolsRegion = scannable.slice(toolsMatch.index, toolsEnd)
+    const configMatch = /\bconfig\s*:\s*\{/.exec(toolsRegion)
+    if (!configMatch) continue
+    const configStart = toolsMatch.index + configMatch.index + configMatch[0].length - 1
+    const configEnd = findMatchingClose(scannable, configStart)
+    if (configEnd === -1) continue
+
+    const configRegion = scannable.slice(configStart, configEnd)
+    const paramsMatch = /\bparams\s*(?::\s*)?\(/.exec(configRegion)
+    if (!paramsMatch) continue
+    const argsStart = configStart + paramsMatch.index + paramsMatch[0].length - 1
+    const argsEnd = findMatchingClose(scannable, argsStart, '(', ')')
+    if (argsEnd === -1) continue
+
+    const afterArgs = scannable.slice(argsEnd, configEnd)
+    const bodyMatch = /^\s*(?::[^=({]*)?(?:=>\s*)?([({])/.exec(afterArgs)
+    if (!bodyMatch) continue
+    const open = bodyMatch[1] as '(' | '{'
+    const bodyStart = argsEnd + bodyMatch[0].length - 1
+    const bodyEnd = findMatchingClose(scannable, bodyStart, open, open === '(' ? ')' : '}')
+    if (bodyEnd === -1) continue
+    ranges.push([bodyStart, bodyEnd])
+  }
+
+  return ranges
+}
+
+/**
+ * Collects the tool-param names a block's own `tools.config.params` mapper writes.
+ *
+ * A block can supply a hidden tool param without ever declaring a subBlock of that name:
+ * Cal.com assembles `result.attendee` from `attendeeName`/`attendeeEmail`/`attendeeTimeZone`,
+ * JSM renames its `assetWorkspaceId` field to `workspaceId`, and Textract renames its
+ * `document` field to `file`. All are user-driven and must stay documented, so this scan
+ * catches both shapes — `<anyIdentifier>.<param> = …` assignments (the accumulator is named
+ * `result` in one block and `parameters` in another, so the name is never assumed) and
+ * `<param>:` keys of the objects the mapper returns.
+ *
+ * The rule is deliberately biased toward keeping. Object keys are collected without proving
+ * they are top-level params, so a key on a nested object (Cal.com's `attendee.name`) can keep
+ * a same-named hidden param that the mapper never actually supplies. That false keep costs a
+ * reader one hard-to-set row; a false drop hides a required input — the exact failure this
+ * filter exists to prevent, and one it has already caused. When the two are in tension, keep.
+ *
+ * Scanning runs on the blanked copy, so a commented-out or string-embedded mapper cannot
+ * contribute names.
+ */
+export function extractMapperWrittenParamIds(blockContent: string): string[] {
+  const scannable = blankStringsAndComments(blockContent)
+  const ids = new Set<string>()
+
+  for (const [start, end] of findMapperBodyRanges(scannable)) {
+    const body = scannable.slice(start, end)
+
+    const assignmentRegex = /(?:^|[^.\w$])[A-Za-z_$][\w$]*\.([A-Za-z_$][\w$]*)\s*=(?!=)/g
+    let match: RegExpExecArray | null
+    while ((match = assignmentRegex.exec(body)) !== null) ids.add(match[1])
+
+    const keyRegex = /(?:^|[^?.\w$])([A-Za-z_$][\w$]*)\s*:/g
+    while ((match = keyRegex.exec(body)) !== null) ids.add(match[1])
+
+    /**
+     * Quoted keys survive blanking only as their delimiters, so the name is read back from
+     * the original content at the same index — `blankStringsAndComments` is length-preserving.
+     */
+    const quotedKeyRegex = /(['"])[^'"\n]*\1\s*:/g
+    while ((match = quotedKeyRegex.exec(body)) !== null) {
+      const keyStart = start + match.index
+      const original = blockContent.slice(keyStart, keyStart + match[0].length)
+      const name = /(['"])([A-Za-z_$][\w$]*)\1/.exec(original)?.[2]
+      if (name) ids.add(name)
+    }
+  }
+
+  return [...ids]
+}
+
+/**
+ * Every param name the block itself supplies — via a user-facing `subBlocks` field or via
+ * its `tools.config.params` mapper. A hidden tool param in this set stays in the public
+ * Input table; the rest are genuinely resolver-derived and stay filtered out.
+ */
+export function extractBlockSuppliedParamIds(blockContent: string, blockName = 'block'): string[] {
+  return [
+    ...new Set([
+      ...extractUserSettableParamIds(blockContent, blockName),
+      ...extractMapperWrittenParamIds(blockContent),
+    ]),
+  ]
+}
+
 /**
  * Extract operation options from the subBlock with id: 'operation' (if present).
  * Returns { label, id } pairs — label is the display name, id is the option's id field
@@ -1435,7 +1548,7 @@ function extractBlockConfigFromContent(
     const triggerIds = extractTriggersAvailable(blockContent, fileContent)
     let ownSettableParamIds: string[] = []
     try {
-      ownSettableParamIds = extractUserSettableParamIds(blockContent, blockName)
+      ownSettableParamIds = extractBlockSuppliedParamIds(blockContent, blockName)
     } catch (error) {
       /**
        * Recorded rather than rethrown so one unreadable block cannot drop itself from the